요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
=======================================
tgafb - TGA graphics framebuffer driver
=======================================
This is a driver for DECChip 21030 based graphics framebuffers, a.k.a. TGA
cards, which are usually found in older Digital Alpha systems. The
following models are supported:
- ZLxP-E1 (8bpp, 2 MB VRAM)
- ZLxP-E2 (32bpp, 8 MB VRAM)
- ZLxP-E3 (32bpp, 16 MB VRAM, Zbuffer)
This version is an almost complete rewrite of the code written by Geert
Uytterhoeven, which was based on the original TGA console code written by
Jay Estabrook.
Major new features since Linux 2.0.x:
* Support for multiple resolutions
* Support for fixed-frequency and other oddball monitors
(by allowing the video mode to be set at boot time)
User-visible changes since Linux 2.2.x:
* Sync-on-green is now handled properly
* More useful information is printed on bootup
(this helps if people run into problems)
This driver does not (yet) support the TGA2 family of framebuffers, so the
PowerStorm 3D30/4D20 (also known as PBXGB) cards are not supported. These
can however be used with the standard VGA Text Console driver.
Configuration
=============
You can pass kernel command line options to tgafb with
`video=tgafb:option1,option2:value2,option3` (multiple options should be
separated by comma, values are separated from options by `:`).
Accepted options:
========== ============================================================
font:X default font to use. All fonts are supported, including the
SUN12x22 font which is very nice at high resolutions.
mode:X default video mode. The following video modes are supported:
640x480-60, 800x600-56, 640x480-72, 800x600-60, 800x600-72,
1024x768-60, 1152x864-60, 1024x768-70, 1024x768-76,
1152x864-70, 1280x1024-61, 1024x768-85, 1280x1024-70,
1152x864-84, 1280x1024-76, 1280x1024-85
========== ============================================================
Known Issues
============
The XFree86 FBDev server has been reported not to work, since tgafb doesn't do
mmap(). Running the standard XF86_TGA server from XFree86 3.3.x works fine for
me, however this server does not do acceleration, which make certain operations
quite slow. Support for acceleration is being progressively integrated in
XFree86 4.x.
When running tgafb in resolutions higher than 640x480, on switching VCs from
tgafb to XF86_TGA 3.3.x, the entire screen is not re-drawn and must be manually
refreshed. This is an X server problem, not a tgafb problem, and is fixed in
XFree86 4.0.
Enjoy!
Martin Lucina <[email protected]>
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 TGA 카드와 변경 사항
1-32`tgafb`는 보통 구형 Digital Alpha 시스템에 장착된 DECChip 21030 기반 그래픽 framebuffer, 즉 TGA 카드용 드라이버입니다. 지원 모델은 8 bpp와 2 MB VRAM의 ZLxP-E1, 32 bpp와 8 MB VRAM의 ZLxP-E2, 32 bpp·16 MB VRAM·Zbuffer의 ZLxP-E3입니다.
이 버전은 Jay Estabrook의 원래 TGA console 코드를 바탕으로 Geert Uytterhoeven이 작성한 코드를 거의 전면 재작성한 것입니다.
Linux 2.0.x 이후 주요 기능은 여러 해상도 지원과 부팅 때 video mode를 지정해 fixed-frequency 등 특이한 monitor를 지원하는 것입니다. Linux 2.2.x 이후 사용자에게 보이는 변화는 sync-on-green의 올바른 처리와 문제 분석에 유용한 더 자세한 부팅 정보입니다.
TGA2 계열은 아직 지원하지 않으므로 PowerStorm 3D30/4D20, 즉 PBXGB 카드는 사용할 수 없습니다. 다만 이 카드는 표준 VGA Text Console 드라이버로 사용할 수 있습니다.
=======================================
tgafb - TGA graphics framebuffer driver
=======================================
This is a driver for DECChip 21030 based graphics framebuffers, a.k.a. TGA
cards, which are usually found in older Digital Alpha systems. The
following models are supported:
- ZLxP-E1 (8bpp, 2 MB VRAM)
- ZLxP-E2 (32bpp, 8 MB VRAM)
- ZLxP-E3 (32bpp, 16 MB VRAM, Zbuffer)
This version is an almost complete rewrite of the code written by Geert
Uytterhoeven, which was based on the original TGA console code written by
Jay Estabrook.
Major new features since Linux 2.0.x:
* Support for multiple resolutions
* Support for fixed-frequency and other oddball monitors
(by allowing the video mode to be set at boot time)
User-visible changes since Linux 2.2.x:
* Sync-on-green is now handled properly
* More useful information is printed on bootup
(this helps if people run into problems)
This driver does not (yet) support the TGA2 family of framebuffers, so the
PowerStorm 3D30/4D20 (also known as PBXGB) cards are not supported. These
can however be used with the standard VGA Text Console driver.
커널 명령행과 지원 모드
33-53커널 명령행은 `video=tgafb:option1,option2:value2,option3` 형식입니다. 여러 옵션은 쉼표로, 옵션과 값은 콜론으로 구분합니다.
`font:X`는 기본 글꼴을 지정하며 고해상도에 적합한 `SUN12x22`를 포함한 모든 글꼴을 지원합니다.
`mode:X`는 기본 video mode를 지정합니다. 지원 목록은 `640x480-60`, `800x600-56`, `640x480-72`, `800x600-60`, `800x600-72`, `1024x768-60`, `1152x864-60`, `1024x768-70`, `1024x768-76`, `1152x864-70`, `1280x1024-61`, `1024x768-85`, `1280x1024-70`, `1152x864-84`, `1280x1024-76`, `1280x1024-85`입니다.
Configuration
=============
You can pass kernel command line options to tgafb with
`video=tgafb:option1,option2:value2,option3` (multiple options should be
separated by comma, values are separated from options by `:`).
Accepted options:
========== ============================================================
font:X default font to use. All fonts are supported, including the
SUN12x22 font which is very nice at high resolutions.
mode:X default video mode. The following video modes are supported:
640x480-60, 800x600-56, 640x480-72, 800x600-60, 800x600-72,
1024x768-60, 1152x864-60, 1024x768-70, 1024x768-76,
1152x864-70, 1280x1024-61, 1024x768-85, 1280x1024-70,
1152x864-84, 1280x1024-76, 1280x1024-85
========== ============================================================
XFree86 관련 알려진 문제
54-71`tgafb`가 `mmap()`을 구현하지 않기 때문에 XFree86 FBDev server는 동작하지 않는다고 보고되었습니다. XFree86 3.3.x의 표준 `XF86_TGA` server는 동작하지만 acceleration을 하지 않아 일부 작업이 상당히 느립니다. acceleration 지원은 XFree86 4.x에 점진적으로 통합되었습니다.
640x480보다 높은 해상도에서 `tgafb`에서 `XF86_TGA` 3.3.x로 virtual console을 전환하면 전체 화면이 다시 그려지지 않아 수동 refresh가 필요합니다. 이는 `tgafb`가 아니라 X server 문제이며 XFree86 4.0에서 수정되었습니다. 작성자는 Martin Lucina입니다.
mmap과 acceleration 제약에 따라 동작 경로가 달라집니다.
Known Issues
============
The XFree86 FBDev server has been reported not to work, since tgafb doesn't do
mmap(). Running the standard XF86_TGA server from XFree86 3.3.x works fine for
me, however this server does not do acceleration, which make certain operations
quite slow. Support for acceleration is being progressively integrated in
XFree86 4.x.
When running tgafb in resolutions higher than 640x480, on switching VCs from
tgafb to XF86_TGA 3.3.x, the entire screen is not re-drawn and must be manually
refreshed. This is an X server problem, not a tgafb problem, and is fixed in
XFree86 4.0.
Enjoy!
Martin Lucina <[email protected]>
요약·해설
tgafb.rst:1-71`tgafb`는 Digital Alpha의 DECChip 21030 TGA 카드를 지원하고 여러 부팅 모드와 sync-on-green을 제공하지만 TGA2와 XFree86 FBDev의 mmap 경로는 지원하지 않습니다.