'\" t
.\"     Title: STATUS
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "STATUS" "nged" "04/13/2022" "BRL\-CAD" "BRL\-CAD User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
status \- Without a subcommand, the \fBstatus\fR command returns the following information: current state, view size of the current display manager, the conversion factor from local model units to the base units (mm) stored in the database, and the view matrices of the current display manager\&.
.SH "SYNOPSIS"
.HP \w'\fBstatus\fR\ 'u
\fBstatus\fR [\fIsubcommands\fR]
.SH "DESCRIPTION"
.PP
Without a subcommand, the
\fBstatus\fR
command returns the following information: current state, view size of the current display manager, the conversion factor from local model units to the base units (mm) stored in the database, and the view matrices of the current display manager\&.
\fBStatus\fR
accepts the following subcommands:
.PP
\fBstate\fR
.RS 4
Get the current state of MGED (i\&.e\&., VIEWING, SOL PICK, SOL EDIT, OBJ PICK, OBJ PATH, OBJ EDIT, or VERTPICK)\&.
.RE
.PP
\fBViewscale\fR
.RS 4
Get the view scale\&.
.RE
.PP
\fBbase2local\fR
.RS 4
Get the conversion factor from base units (mm) to local units\&.
.RE
.PP
\fBlocal2base\fR
.RS 4
Get the conversion factor from local units to base units (mm)\&.
.RE
.PP
\fBtoViewcenter\fR
.RS 4
Get the matrix that describes the location of the view center\&.
.RE
.PP
\fBViewrot\fR
.RS 4
Get the matrix that describes the view orientation\&.
.RE
.PP
\fBmodel2view\fR
.RS 4
Get the model to view conversion matrix\&.
.RE
.PP
\fBview2model\fR
.RS 4
Get the view to model conversion matrix\&.
.RE
.PP
\fBmodel2objview\fR
.RS 4
Get the model to view conversion matrix\&. This matrix also includes changes made during editing\&.
.RE
.PP
\fBobjview2model\fR
.RS 4
Get the view to model conversion matrix\&. This matrix also includes changes made during editing\&.
.RE
.PP
\fBhelp\fR
.RS 4
Print the usage message\&.
.RE
.SH "EXAMPLES"
.PP
The three examples show the use of the
\fBstatus\fR
command with and without subcommands\&.
.PP
\fBExample\ \&1.\ \&Get default information such as current state, view size of the current display manager, the conversion factor from local model units to the base units (mm) stored in the database, and the view matrices of the current display manager.\fR
.PP

mged>\fBstatus\fR
.PP
Gets default information (i\&.e\&., state, view size, local2base, toViewcenter, Viewrot, model2view and view2model)\&.
.PP
\fBExample\ \&2.\ \&Get the view rotation matrix.\fR
.PP

mged>\fBstatus Viewrot\fR
.PP
Gets the view rotation matrix\&.
.PP
\fBExample\ \&3.\ \&Get the edit state.\fR
.PP

mged>\fBstatus state\fR
.PP
Gets the edit state\&.
.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
