DM(nged)

Provides a means to interact with the display manager at a lower level.

📅 published 7.44.0, from nixpkgs unstable

💅 DM(nged) — the deep-lore display manager page 🎀

okay bestie, so this is dm from the BRL-CAD User Commands manual, and she is lowkey the backstage door to the display manager. No cap. Let's get into it. ✨

🌸 NAME 🌸

dm — gives you a whole way to interact with the display manager at a lower level. that's it, that's the vibe. 🫶

⭐ SYNOPSIS ⭐

dm [-h] [-v] {subcommand} [args]

🔥 DESCRIPTION 🔥

Provides a means to interact with the display manager at a lower level. like, you're not just clicking around anymore, you're speaking to it directly. main character energy fr.

The dm command accepts the following subcommands:

✨ OPTIONS ✨

  • -h, --help — print help. that's the whole thing. she just tells you stuff. 💖
  • -v, --verbose — increases the top-level command verbosity. more words, more lore.

🦋 the subcommands 🦋

  • set var val — the set subcommand gives you a way to set or query display-manager-specific variables. invoke it with no arguments at all? it returns a list of every available internal display manager variable. give it only the var argument? you get that variable's value back. give it both var and val? then var gets set to val. slay, three modes, all iconic. 👑
  • size width height — the size subcommand sets or queries the window size. no arguments? the display manager's window size comes back at you. specify width and height? the display manager makes a request to have its window resized. ⚠️ and here's the tea: a size request is just that — a request — so it may be ignored, especially if the user has resized the window using the mouse. don't @ her. 🙈
  • m button x y — the m subcommand simulates an M command. the button argument decides which mouse button is triggering the call to this command. that value gets used in the event handler to effect dragging the faceplate scrollbars. the x and y arguments are in X screen coordinates, which get converted to MGED screen coordinates before being passed to the M command. coordinate glow-up fr fr. ✨
  • am [r] [t] [s] xy — the am subcommand effects mged's alternate mouse mode. alternate mouse mode hands the user a whole different way of manipulating the view or an object — for example, dragging an object, or maybe rotating the view while using the mouse. the first argument says what type of operation to perform (i.e., r for rotation, t for translation, and s for scale). the x and y arguments are in X screen coordinates and get transformed appropriately before being passed to the knob command. 🌀
  • adc [1] [2] [t] [d] xy — the adc subcommand gives you a way of manipulating the angle distance cursor while using the mouse. the first argument says the type of operation to perform (i.e., 1 for angle 1, 2 for angle 2, t for translate, and d for tick distance). the x and y arguments are in X screen coordinates and get transformed appropriately before being passed to the adc command (i.e., not dm adc). read that again bestie, it's a whole different command. 💀
  • con [r] [t] [s] [x] [y] [z] xpos ypos — this form of the con subcommand gives you a way to effect constrained manipulation of the view or an object while using the mouse. it simulates the behavior of sliders without taking up screen real estate. iconique. the first argument says the type of operation to perform (i.e., r for rotation, t for translation, and s for scale). the <x|y|z> argument is the axis of rotation, translation, or scale. the xpos and ypos arguments are in X screen coordinates and get transformed appropriately before being passed to the knob command. 🎀
  • con [a] [x] [y] [1] [2] [d] xpos ypos — this form of the con subcommand gives you a way to effect constrained manipulation of the angle distance cursor while using the mouse. again with the slider simulation, again no screen real estate used up. the first argument indicates that this is to be applied to the angle distance cursor. the next argument says the type of operation to perform (i.e., x for translate in the x direction, y for translate in the y direction, 1 for angle 1, 2 for angle 2, and d for tick distance). the xpos and ypos arguments are in X screen coordinates and get transformed appropriately before being passed to the knob command. 🦋
  • valid [ogl] [X] [wgl] [rtgl] [...] — the valid subcommand gives you a way to determine if a particular type of display manager (X Windows, OpenGL, etc.) is available. if the display manager type is supported, the string denoting that type (X, ogl, etc.) gets returned back to you; otherwise nothing is returned. a little vibe check for your display manager. 🧚

🌈 EXAMPLES 🌈

these examples show the dm command flexing with its various subcommands, as presented in the Description section. 💜

Example 1. List the available display manager internal variables.

mged>dm set

Lists the available display manager internal variables. 🍓

Example 2. Turn on perspective projection in the display using var and val arguments.

mged>dm set perspective 1

Turns on perspective projection in the display. 👑

Example 3. Query the display manager's window size.

mged>dm size

The display manager's window size is returned. 📐

Example 4. Resize the display manager window.

mged>dm size 900 900

The display manager window is resized to 900 x 900. (as a request, remember 😌)

Example 5. Simulate a button2 press at specific screen coordinates.

mged>dm m 2 100 200

Simulates a button2 press at (100, 200) in X screen coordinates. 🖱️

Example 6. Use the alternate mouse mode to rotate an image.

mged>dm am r 400 100

Starts an alternate mouse mode rotation at (400, 100). 🔄

Example 7. Start a tick distance manipulation with the mouse.

mged>dm adc d 300 200

Starts a tick distance manipulation at (300, 200). 📏

Example 8. Start a constrained translation down the Z axis using the mouse.

mged>dm con t z 200 200

Starts a constrained translation down the Z axis. ⬇️

Example 9. Start a constrained tick distance manipulation using the mouse.

mged>dm con a d 200 100

Starts a constrained tick distance manipulation. 🎯

Example 10. End the mouse drag.

mged>dm idle

Ends the drag. periodt. 💅

🫶 AUTHOR 🫶

BRL-CAD Team — legends, honestly.

😭 BUG REPORTS 😭

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. if something's cursed, tell the devs, not me, i'm just the messenger. 💌

ngl the footers are never the fun part but we're doing it for completeness bestie: this is BRL-CAD, page DM(nged). love that for us. 🌸✨🎀
📦 where this page comes from