db&w documentation wiki

finest software | finest docs

Site Tools


qckpck2018:qckhud

qckHuD

qckHuD is an addition to qckPck that will displays a variety of information about the current scene as well as items as an overlay.

The type, location and colour of the information can be configured.

qckHuD is a master plugin that is saved with the scene. It comes with four generic plugins which can be added to a menu or attached to a shortcut:

  • Add qckHuD Adds the plugin to the current scene, if it's not a part of it yet, and opens the user interface.
  • Show qckHuD Shows the qckHuD overlay
  • Hide qckHuD Hides the qckHuD overlay
  • Toggle qckHuD Toggles the visibility of the qckHuD overlay. Best assigned to a keyboard shortcut.

qckHuD Master Plugin

Opening the master plugin displays a user interface to edit the overlays for the current scene. This user interface can be resized freely.

Presets

This uses the same presets system as our other plugins: Presets

About

List of Overlays

This displays a list of all current overlays.

Overlay List

This displays all overlays. You can drag and drop items to re-arrange them. Hierarchies of items are supported. The Viewport column shows for which viewport types the overlay is being used: Orhtogonal, Perspective, Light, Camera or Schematic view.

The second column shows a rotate icon if the overlay (as well as it's children) will be used for multiple selected items.

The third column shows the overlay text itself.

You can left click on this list to select an overlay item to edit. Right clicking on an item opens a context menu:

  • Add
    Adds a new overlay at the end of the list
  • Add Child
    Adds a new overlay as the child of the current selection
  • Remove
    Removes the current item. If it has child items, you will be prompted if you really want to delete it, including the children.
  • Export Selected…
    Exports the selected item (and children) as a file.
  • Import
    Imports a file saved with export. The imported overlays will be added to the list.

Add Overlay

This adds a new overlay to the end of the list.

Add Child Overlay

This adds a new overlay as the child of the currently selected item.

Remove Overlay

Removes the current item. If it has child items, you will be prompted if you really want to delete it, including the children.

Overlay

This is the text displayed as an overlay. You may include any of the available Variables to dynamically extract data from the current scene.

Hide if not used

If the overlay contains variables, but none of them can retrieve any data in the current context (i.e. light information but you have a bone selected) then the overlay will not be displayed at all and ignored.

Append Variable...

This appends any of the selected Variables to the current overlay.

Append Item...

This appends the selected item name as a variable limiter. See Variables for more information.

Overlay Properties (right hand side)

These controls allow you to edit the individual attributes of every overlay.

Enabled

This enables or disables the current overlay completely, including children.

Loop Multiselection

If multiple items are selected, this overlay - as well as all children - will be displayed for every selected item.

Use Parent Style

This option is only available if the overlay is a child. It will inherit all of the following options from the parent overlay item.

Viewport Visibility

This defines when this overlay is visible in a viewport.

  • Always Visible The overlay is always visible
  • Active Viewport only The overlay is only visible in the viewport you're interacting with. This is triggered by the first mouse interaction in a viewport.
  • Inactive Viewport Only The overly is only visible in a viewport you're not interacting with. Essentially the opposite of the previous option.
  • Never Visible This effectively disables the overlay

Viewport Type

This defines which kind of viewport the overlay will be visible at.

Overlay Position

Overlays can be positioned along the sides of viewports or the centre.

Colour

This defines the colour of the overlay text.

Opacity

This defines the opacity of the text.

Background

The following controls allow you to enable a background for each of the 9 possible overlay positions. You can also change the colour as well as the opacity.

Position

This selects the background position to edit.

Enable

En- / disables the background for the current position.

Colour

Defines the colour for the background.

Opacity

Defines the opacity for the background.

Variables

Variables need to be enclosed in % within the overlay, i.e.

Scene: %scene.name% - %scene.num_polygons% polygons

Variables related to specific items can be limited to a specific item as opposed to the current selection. This is done by adding the item name in front of the variable, designated by a $, i.e.

$my_Camera%camera.zoom%

If you actually want the characters % or $ to show up in an overlay, just type them twice. %% shows a single %, $$ a single $.

Scene

scene.fps Frames per second of the current scene
scene.time Time of the current frame in the scene in seconds
scene.frame Current frame of the scene
scene.frame_start
scene.frame_end
scene.frame_step
scene.frame_width
scene.frame_height
scene.name
scene.filename
scene.num_points
scene.num_polygons
scene.render_camera

Item

item.name
item.positionPosition of the item in local coordinates. Append .x/.y/.z to display individual components
item.rotationRotation of the item in local degrees. Append .h/.p/.b to display individual components
item.scalingScale of the item in local coordinates. Append .x/.y/.z to display individual components
item.world_positionWorld position of the item in local coordinates. Append .x/.y/.z to display individual components
item.position_controller
item.rotation_controller
item.scaling_controller
item.parentName of the parent item
item.typeType of item
item.targetName of the target item
item.goal
item.breadcrumbsThe complete hierarchy of items to the selected item

Object

object.filename
object.num_points
object.num_polygons

Light

light.intensity
light.type
light.quality
light.flags

Camera

camera.zoom
camera.focal_length
camera.focal_distance
camera.f-stop
camera.resolution

Bone

bone.strength
bone.twist
bone.weightmap
bone.rest_length
bone.falloff
bone.type
bone.flags
bone.limitsMinimum and Maximum rotation limits. Append .h/.p/.b to display individual components

If you think that any variables are missing to display the information you need, please get in touch with us and we’ll see if we can add them.

qckpck2018/qckhud.txt · Last modified: 2019/06/03 13:03 by lightwolf