Điều Chỉnh Bố Trí Bàn Phím -- Keymap Customization¶

Phím -- Keys¶

Những Phím Có Thể Sử Dụng -- Available Keys¶

When customizing keymaps it's useful to use keys which won't conflict with Blender's default keymap.

Đây là những phím chưa sử dụng đến và có khả năng sẽ không bao giờ sử dụng đến trong tương lai.

F-Keys (F5 - F8)

These F-keys (including modifier combination) have been intentionally kept free for users to bind their own keys to.

OSKey (also known as the Windows-Key, Cmd or Super)

Blender không sử dụng phím này cho bất cứ một gắn kết nào cả.

macOS is an exception, where Cmd replaces Ctrl except in cases it would conflict with the system's key bindings.

Nháy Kép Phím Bổ Trợ -- Modifier Double Click

Gắn kết các phím bổ trợ làm những phím chính cũng được hỗ trợ. Để tránh sự xung khắc xảy ra với những sử dụng thông thường thì bạn có thể gắn kết nó với nháy kép.

Những Phím Đa-Hành Động -- Multi-Action Keys¶

Bấm/Kéo Rê -- Click/Drag¶

It's possible to configure a single key to perform multiple operations using Click event instead of Press. Then you may bind Drag to a separate action.

Việc làm này có lợi cho việc pha trộn các hành động, mà trong đó, nó sử dụng sự kiện kéo rê, chẳng hạn, bật/tắt một sắp đặt nào đó với phím tab, kéo rê để mở trình đơn hình rẻ quạt, hiển thị toàn bộ các tùy chọn liên quan đến sắp đặt.

Bấm/Hiệu Chỉnh -- Click/Tweak¶

Không giống với bấm/kéo rê, cái này chỉ hoạt động với các nút bấm của chuột mà thôi, song có lợi thế là các sự kiện hiệu chỉnh có khả năng là hữu hướng (directional).

To use this, events in this keymap must use Click instead of Press, then you can bind Tweak actions to the mouse buttons.

This is used in the default keymap in the 3D Viewport, Alt-MMB dragging in different directions rotates the view.

Những Thao Tác Thông Thường -- Common Operations¶

Phần này sẽ liệt kê những thao tác chung hữu ích có thể sử dụng được.

Những Bố Trí Phím cho Trình Đơn Bật Lên -- Key Bindings for Pop-Ups¶

Menus and panels can be assigned key shortcuts, even if they're only accessible from submenus elsewhere.

Mở một Trình Đơn Bật Lên: Mở bất cứ một trình đơn nào dùng cái bấm của phím.
Mở một trình đơn rẻ quạt (wm.call_menu_pie): Mở bất cứ trình đơn rẻ quạt nào dùng cái bấm của phím.
Mở một Bảng (wm.call_panel): Mở một bảng bật lên (còn được gọi là một pop-over)

Những Gắn Kết về Phím Bấm cho các Tính Chất -- Key Bindings for Properties¶

There are many properties you might want to bind a key with. To avoid having to define operators for each property, there are generic operators for this purpose:

Các thao tác (phép toán) để điều chỉnh tính chất khởi đầu bằng wm.context_.

Một số cái thuộc thể loại này bao gồm:

wm.context_toggle toggle a Boolean property.
wm.context_cycle_enum tuần hoàn một tính chất bảng liệt kê (enum) từ đầu đến cuối, hoặc ngược lại.
wm.context_menu_enum hiển thị một trình đơn bật lên cho một tính chất bảng liệt kê (enum property).
wm.context_pie_enum hiển thị một trình đơn rẻ quạt cho một tính chất bảng liệt kê (enum property).
wm.context_scale_float scale a number (used for increasing / decreasing brush size for example).
wm.context_toggle_enum đảo lật giữa hai tùy chọn của một tùy chọn của một bảng liệt kê (enum).
wm.context_modal_mouse di chuyển con trỏ để tương tác đổi một giá trị.

Xin xem thêm bài bpy.ops.wm để xem toàn bộ danh sách.

Mỗi một thao tác (phép toán) này có một sắp đặt về đường dẫn dữ liệu (data_path) để tham chiếu tính chất hòng thay đổi.

To find the data_path, basic Python knowledge is needed.

For example, you can use the Python Console to access a Boolean property you wish to map to a key:

bpy.context.object.show_name

Để gắn kết cái này vào một phím bấm, tạo thêm một bố trí bàn phím mới, xin hãy sử dụng thao tác (phép toán) wm.context_toggle với đường dẫn dữ liệu (data_path) đặt thành object.show_name (lưu ý, tiền tố tàng ẩn bpy.context).

Xin xem thêm bài bpy.context để biết về những thuộc tính ngữ cảnh khác.

Chúng ta có thể sử dụng tài liệu về giao diện lập trình Python (Python API) để tìm các tính chất, hoặc sử dụng tính năng tự động hoàn thành (auto-complete) của bàn giao tiếp Python (Python Console) để xem xét các tính chất vốn có.