Chi Tiết Hàm Đồ Họa (Gfx Functions) Trong Amibroker AFL: Tạo Hình Dạng, Văn Bản & Tùy Biến Biểu Đồ

Chào các bạn! Trong bài viết trước, chúng ta đã giới thiệu về khái niệm Hàm đồ họa (Gfx Functions) và các chế độ làm việc của chúng trong Amibroker AFL. Hôm nay, chúng ta sẽ đi sâu vào thực hành, tìm hiểu cách sử dụng các hàm Gfx cụ thể để vẽ hình dạng, tùy chỉnh màu sắc, và thêm văn bản trực tiếp lên biểu đồ của bạn. Đây là những công cụ mạnh mẽ giúp bạn cá nhân hóa giao diện Amibroker theo cách độc đáo nhất.

1. Các Hàm Vẽ Hình Dạng Cơ Bản

Trước khi vẽ bất kỳ hình dạng nào, bạn cần thiết lập màu viền (pen) và màu nền (solid brush) cho đối tượng của mình.

a. GfxSelectPen( Color, Width, PenStyle ) – Thiết lập viền (Outline)

• Chức năng: Chọn màu, độ dày và kiểu của đường viền cho các hình dạng sắp vẽ.
• Tham số:
  • Color: Màu sắc của đường viền (ví dụ: colorGreen, colorRed, colorBlue).
  • Width: Độ dày của đường viền (ví dụ: 1, 2, 3).
  • PenStyle: Kiểu đường viền (ví dụ: 0 cho nét liền – mặc định, hoặc các giá trị khác cho nét đứt).
• Ví dụ: GfxSelectPen( colorGreen, 2, 0 ); (Viền xanh lá cây, dày 2 pixel, nét liền).

b. GfxSelectSolidBrush( Color ) – Thiết lập nền (Background Fill)

• Chức năng: Chọn màu sắc để tô đầy bên trong hình dạng.
• Tham số:
  • Color: Màu nền (ví dụ: colorYellow, colorAqua).
• Ví dụ: GfxSelectSolidBrush( colorYellow ); (Nền màu vàng).

c. GfxRoundRect( X1, Y1, X2, Y2, ArcWidth, ArcHeight ) – Vẽ hình chữ nhật bo góc

• Chức năng: Vẽ một hình chữ nhật với các góc được bo tròn.
• Tham số:
  • X1, Y1: Tọa độ pixel của góc trên bên trái của hình chữ nhật.
  • X2, Y2: Tọa độ pixel của góc dưới bên phải của hình chữ nhật.
  • ArcWidth, ArcHeight: Độ bo tròn của các góc. Giá trị càng lớn, góc càng tròn và mượt.
• Ví dụ: GfxRoundRect( 100, 100, 300, 200, 30, 30 );

d. GfxCircle( X, Y, Radius ) – Vẽ hình tròn

• Chức năng: Vẽ một hình tròn.
• Tham số:
  • X, Y: Tọa độ pixel của tâm hình tròn.
  • Radius: Bán kính của hình tròn (tính bằng pixel).
• Ví dụ: GfxCircle( 200, 150, 50 );

Nguyên tắc quan trọng: Luôn gọi GfxSelectPen() và GfxSelectSolidBrush() trước khi bạn gọi hàm vẽ hình dạng (ví dụ: GfxRoundRect(), GfxCircle()). Nếu không, hình dạng sẽ được vẽ với các thuộc tính mặc định (mờ hoặc không màu).

2. Các Hàm Xử Lý Văn Bản Trên Biểu Đồ

Bạn không chỉ có thể vẽ hình dạng mà còn có thể thêm văn bản tùy chỉnh lên biểu đồ.

a. GfxSetBkMode( Mode ) – Thiết lập chế độ nền văn bản

• Chức năng: Kiểm soát nền của văn bản khi nó được vẽ.
• Tham số:
  • 1: Transparent (nền văn bản trong suốt, hiển thị biểu đồ bên dưới).
  • 2: Opaque (nền văn bản đục, che phủ phần biểu đồ bên dưới).
• Ví dụ: GfxSetBkMode( 1 ); (Nền văn bản trong suốt).

b. GfxSelectFont( FaceName, PointSize, Weight, Italic, Underline, StrikeOut ) – Chọn font chữ

• Chức năng: Chọn font chữ, kích thước, độ đậm và các thuộc tính khác cho văn bản sắp vẽ.
• Tham số chính:
  • FaceName: Tên font chữ (ví dụ: "Arial", "Tahoma", "Verdana").
  • PointSize: Kích thước font chữ (ví dụ: 10, 12, 14).
  • Weight: Độ đậm của font chữ. Các giá trị phổ biến: 300 (mỏng), 400 (bình thường), 700 (đậm), 800 (rất đậm).
• Ví dụ: GfxSelectFont( "Arial", 12, 700, False, False, False ); (Font Arial, cỡ 12, in đậm).

c. GfxSetTextColor( Color ) – Thiết lập màu văn bản

• Chức năng: Chọn màu sắc cho văn bản.
• Tham số:
  • Color: Màu sắc của văn bản (ví dụ: colorWhite, colorBlack).
• Ví dụ: GfxSetTextColor( colorWhite ); (Màu chữ trắng).

d. GfxTextOut( Text, X, Y ) – Vẽ văn bản

• Chức năng: Vẽ chuỗi văn bản lên biểu đồ tại một vị trí pixel cụ thể.
• Tham số:
  • Text: Chuỗi văn bản cần hiển thị.
  • X, Y: Tọa độ pixel của điểm bắt đầu của văn bản.
• Ví dụ: GfxTextOut( "HELLO AMIBROKER!", 150, 150 );

Nguyên tắc quan trọng: Tương tự như vẽ hình dạng, bạn cần gọi GfxSetBkMode(), GfxSelectFont(), và GfxSetTextColor() trước khi gọi hàm GfxTextOut() để đảm bảo văn bản được định dạng đúng theo ý muốn.

3. Hàm GfxSetOverlayMode() – Kiểm Soát Lớp Phủ Biểu Đồ

Hàm này rất thú vị vì nó cho phép bạn kiểm soát cách các đối tượng Gfx tương tác với biểu đồ nền.

• Chức năng: Xác định cách các lớp đồ họa Gfx được hiển thị so với biểu đồ cơ bản.
• Tham số:
  • 0: No Overlay (Các đối tượng Gfx được vẽ trên cùng, che phủ hoàn toàn biểu đồ nền nếu chúng trùng lặp). Điều này giống như việc đặt một tấm ảnh lên trên biểu đồ.
  • 1: Transparent Overlay (Các đối tượng Gfx được vẽ trên cùng nhưng trong suốt, cho phép bạn nhìn xuyên qua chúng để thấy biểu đồ nền). Đây là chế độ thường được sử dụng để hiển thị đồng thời cả đối tượng Gfx và biểu đồ nền.
  • 2: Only Overlay (Chỉ hiển thị các đối tượng Gfx; biểu đồ nền sẽ biến mất).
• Ví dụ: GfxSetOverlayMode( 1 ); (Chế độ lớp phủ trong suốt).

4. Ví Dụ AFL Đầy Đủ

5. Lời Khuyên Khi Sử Dụng Gfx Functions

• Thứ tự gọi hàm: Đây là yếu tố quan trọng nhất. Luôn thiết lập các thuộc tính (màu viền, màu nền, font chữ, màu chữ) trước khi gọi hàm vẽ hình dạng hoặc văn bản.
• Thử nghiệm với Pixel: Các tọa độ pixel phụ thuộc vào độ phân giải và kích thước cửa sổ biểu đồ của bạn. Hãy thử nghiệm và điều chỉnh các giá trị X, Y và kích thước cho phù hợp với màn hình của bạn.
• Chế độ mặc định: Bắt đầu với Mode 0 (Pixel Mode) vì nó dễ hiểu và trực quan hơn.

Gfx Functions mở ra một thế giới khả năng tùy biến cho biểu đồ Amibroker, cho phép bạn tạo ra các công cụ trực quan độc đáo, làm nổi bật thông tin quan trọng và nâng cao trải nghiệm phân tích của mình.

• trancotam