XPLMDrawingPhase
This constant indicates which part of drawing we are in. Drawing is done from the back to the front. We get a callback before or after each item. Metaphases provide access to the beginning and end of the 3d (scene) and 2d (cockpit) drawing in a manner that is independent of new phases added via X-Plane implementation.
NOTE: As of XPLM302 the legacy 3D drawing phases (xplm_Phase_FirstScene to xplm_Phase_LastScene) are deprecated. When running under X-Plane 11.50 with the modern Vulkan or Metal backend, X-Plane will no longer call these drawing phases. There is a new drawing phase, xplm_Phase_Modern3D, which is supported under OpenGL and Vulkan which is called out roughly where the old before xplm_Phase_Airplanes phase was for blending. This phase is NOT supported under Metal and comes with potentially substantial performance overhead. Please do NOT opt into this phase if you don’t do any actual drawing that requires the depth buffer in some way!
WARNING: As X-Plane’s scenery evolves, some drawing phases may cease to exist and new ones may be invented. If you need a particularly specific use of these codes, consult Austin and/or be prepared to revise your code as X-Plane evolves.
| Name | Value | Description |
|---|---|---|
| xplm_Phase_FirstScene | "0" | Deprecated as of XPLM302. This is the earliest point at which you can draw in 3-d. |
| xplm_Phase_Terrain | "5" | Deprecated as of XPLM302. Drawing of land and water. |
| xplm_Phase_Airports | "10" | Deprecated as of XPLM302. Drawing runways and other airport detail. |
| xplm_Phase_Vectors | "15" | Deprecated as of XPLM302. Drawing roads, trails, trains, etc. |
| xplm_Phase_Objects | "20" | Deprecated as of XPLM302. 3-d objects (houses, smokestacks, etc. |
| xplm_Phase_Airplanes | "25" | Deprecated as of XPLM302. External views of airplanes, both yours and the AI aircraft. |
| xplm_Phase_LastScene | "30" | Deprecated as of XPLM302. This is the last point at which you can draw in 3-d. |
| xplm_Phase_Modern3D | "31" | A chance to do modern 3D drawing. |
| xplm_Phase_FirstCockpit | "35" | This is the first phase where you can draw in 2-d. |
| xplm_Phase_Panel | "40" | The non-moving parts of the aircraft panel. |
| xplm_Phase_Gauges | "45" | The moving parts of the aircraft panel. |
| xplm_Phase_Window | "50" | Floating windows from plugins. |
| xplm_Phase_LastCockpit | "55" | The last chance to draw in 2d. |
| xplm_Phase_LocalMap3D | "100" | Removed as of XPLM300; Use the full-blown XPLMMap API instead. |
| xplm_Phase_LocalMap2D | "101" | Removed as of XPLM300; Use the full-blown XPLMMap API instead. |
| xplm_Phase_LocalMapProfile | "102" | Removed as of XPLM300; Use the full-blown XPLMMap API instead. |