Attributes

Axis3

Attributes

`alignmode`

Defaults to Inside()

The alignment of the scene in its suggested bounding box.

`aspect`

Defaults to (1.0, 1.0, 2 / 3)

Controls the lengths of the three axes relative to each other.

Options are:

A three-tuple of numbers, which sets the relative lengths of the x, y and z axes directly
:data which sets the length ratios equal to the limit ratios of the axes. This results in an "unsquished" look where a cube in data space looks like a cube and not a cuboid.
:equal which is a shorthand for (1, 1, 1)

Example: Three-tuple aspects

using CairoMakie
fig = Figure()

Axis3(fig[1, 1], aspect = (1, 1, 1), title = "aspect = (1, 1, 1)")
Axis3(fig[1, 2], aspect = (2, 1, 1), title = "aspect = (2, 1, 1)")
Axis3(fig[2, 1], aspect = (1, 2, 1), title = "aspect = (1, 2, 1)")
Axis3(fig[2, 2], aspect = (1, 1, 2), title = "aspect = (1, 1, 2)")

fig

Example: `:data` and `:equal` aspects

using CairoMakie
using FileIO

fig = Figure()

brain = load(assetpath("brain.stl"))

ax1 = Axis3(fig[1, 1], aspect = :equal, title = "aspect = :equal")
ax2 = Axis3(fig[1, 2], aspect = :data, title = "aspect = :data")

for ax in [ax1, ax2]
    mesh!(ax, brain, color = :gray80)
end

fig

`azimuth`

Defaults to 1.275pi

The azimuth (left / right) angle of the camera.

At azimuth = 0, the camera looks at the axis from a point on the positive x axis, and rotates to the right from there with increasing values. At the default value 1.275π, the x axis goes to the right and the y axis to the left.

Example: `azimuth` values

using CairoMakie
fig = Figure()

for (i, azimuth) in enumerate([0, 0.1, 0.2, 0.3, 0.4, 0.5])
    Axis3(fig[fldmod1(i, 3)...], azimuth = azimuth * pi,
        title = "azimuth = $(azimuth)π", viewmode = :fit)
end

fig

`backgroundcolor`

Defaults to :transparent

The background color

`elevation`

Defaults to pi / 8

The elevation (up / down) angle of the camera. Possible values are between -pi/2 (looking from the bottom up) and +pi/2 (looking from the top down).

Example: `elevation` values

using CairoMakie
fig = Figure()

for (i, elevation) in enumerate([0, 0.05, 0.1, 0.15, 0.2, 0.25])
    Axis3(fig[fldmod1(i, 3)...], elevation = elevation * pi,
        title = "elevation = $(elevation)π", viewmode = :fit)
end

fig

`halign`

Defaults to :center

The horizontal alignment of the scene in its suggested bounding box.

`height`

Defaults to nothing

The height setting of the scene.

`limits`

Defaults to (nothing, nothing, nothing)

The limits that the user has manually set. They are reinstated when calling reset_limits! and are set to nothing by autolimits!. Can be either a tuple (xlow, xhigh, ylow, high, zlow, zhigh) or a tuple (nothingorxlims, nothingorylims, nothingorzlims). Are set by xlims!, ylims!, zlims! and limits!.

`perspectiveness`

Defaults to 0.0

This setting offers a simple scale from 0 to 1, where 0 looks like an orthographic projection (no perspective) and 1 is a strong perspective look. For most data visualization applications, perspective should be avoided because it makes interpreting the data correctly harder. It can be of use, however, if aesthetics are more important than neutral presentation.

Example: `perspectiveness` values

using CairoMakie
fig = Figure()

for (i, perspectiveness) in enumerate(range(0, 1, length = 6))
    ax = Axis3(fig[fldmod1(i, 3)...]; perspectiveness, protrusions = (0, 0, 0, 15),
        title = ":perspectiveness = $(perspectiveness)")
    hidedecorations!(ax)
end

fig

`protrusions`

Defaults to 30

The protrusions control how much gap space is reserved for labels etc. on the sides of the Axis3. Unlike Axis, Axis3 currently does not set these values automatically depending on the properties of ticks and labels. This is because the effective protrusions also depend on the rotation and scaling of the axis cuboid, which changes whenever the Axis3 shifts in the layout. Therefore, auto-updating protrusions could lead to an endless layout update cycle.

The default value of 30 for all sides is just a heuristic and might lead to collisions of axis decorations with the Figure boundary or other plot elements. If that's the case, you can try increasing the value(s).

The protrusions attribute accepts a single number for all sides, or a tuple of (left, right, bottom, top).

Example: Single protrusion

using CairoMakie
    fig = Figure(backgroundcolor = :gray97)
    Box(fig[1, 1], strokewidth = 0) # visualizes the layout cell
    Axis3(fig[1, 1], protrusions = 100, viewmode = :stretch,
        title = "protrusions = 100")
    fig

Example: Removing protrusions

using CairoMakie
    fig = Figure(backgroundcolor = :gray97)
    Box(fig[1, 1], strokewidth = 0) # visualizes the layout cell
    ax = Axis3(fig[1, 1], protrusions = (0, 0, 0, 20), viewmode = :stretch,
        title = "protrusions = (0, 0, 0, 20)")
    hidedecorations!(ax)
    fig

:fit uses a fixed scaling such that a tight sphere around the cuboid touches the frame edge. This means that the scaling doesn't change when rotating the axis (the apparent size of the axis stays the same), but not all available space is used. The chosen aspect is maintained using this setting.
:fitzoom uses a variable scaling such that the closest cuboid corner touches the frame edge. When rotating the axis, the apparent size of the axis changes which can result in a "pumping" visual effect. The chosen aspect is also maintained using this setting.
:stretch pulls the cuboid corners to the frame edges such that the available space is filled completely. The chosen aspect is not maintained using this setting, so :stretch should not be used if a particular aspect is needed.

Example: `viewmode` variants

using CairoMakie
fig = Figure()

for (i, viewmode) in enumerate([:fit, :fitzoom, :stretch])
    for (j, elevation) in enumerate([0.1, 0.2, 0.3] .* pi)

        Label(fig[i, 1:3, Top()], "viewmode = $(repr(viewmode))", font = :bold)

        # show the extent of each cell using a box
        Box(fig[i, j], strokewidth = 0, color = :gray95)

        ax = Axis3(fig[i, j]; viewmode, elevation, protrusions = 0, aspect = :equal)
        hidedecorations!(ax)

    end
end

fig

using CairoMakie
using FileIO

fig = Figure()

brain = load(assetpath("brain.stl"))

ax1 = Axis3(fig[1, 1], title = "xreversed = false")
ax2 = Axis3(fig[2, 1], title = "xreversed = true", xreversed = true)
for ax in [ax1, ax2]
    mesh!(ax, brain, color = getindex.(brain.position, 1))
end

fig

using CairoMakie
using FileIO

fig = Figure()

brain = load(assetpath("brain.stl"))

ax1 = Axis3(fig[1, 1], title = "yreversed = false")
ax2 = Axis3(fig[2, 1], title = "yreversed = true", yreversed = true)
for ax in [ax1, ax2]
    mesh!(ax, brain, color = getindex.(brain.position, 2))
end

fig

`yspinecolor_1`

Defaults to :black

The color of y spine 1 where the ticks are displayed

`yspinecolor_2`

Defaults to :black

The color of y spine 2 towards the center

`yspinecolor_3`

Defaults to :black

The color of y spine 3 opposite of the ticks

`yspinesvisible`

Defaults to true

Controls if the y spine is visible

`yspinewidth`

Defaults to 1

The y spine width

`ytickcolor`

Defaults to :black

The y tick color

`ytickformat`

Defaults to Makie.automatic

The y tick format

`yticklabelcolor`

Defaults to @inherit :textcolor :black

The y ticklabel color

`yticklabelfont`

Defaults to :regular

The y ticklabel font

`yticklabelpad`

Defaults to 5

The y ticklabel pad

`yticklabelsize`

Defaults to @inherit :fontsize 16.0f0

The y ticklabel size

`yticklabelsvisible`

Defaults to true

Controls if the y ticklabels are visible

`yticks`

Defaults to WilkinsonTicks(5; k_min = 3)

The y ticks

`yticksize`

Defaults to 6

The size of the ytick marks.

`yticksvisible`

Defaults to true

Controls if the y ticks are visible

`ytickwidth`

Defaults to 1

The y tick width

`yzpanelcolor`

Defaults to :transparent

The color of the yz panel

`yzpanelvisible`

Defaults to true

Controls if the yz panel is visible

`zautolimitmargin`

Defaults to (0.05, 0.05)

The relative margins added to the autolimits in z direction.

`zgridcolor`

Defaults to RGBAf(0, 0, 0, 0.12)

The z grid color

`zgridvisible`

Defaults to true

Controls if the z grid is visible

`zgridwidth`

Defaults to 1

The z grid width

`zlabel`

Defaults to "z"

The z label

`zlabelalign`

Defaults to Makie.automatic

The z label align

`zlabelcolor`

Defaults to @inherit :textcolor :black

The z label color

`zlabelfont`

Defaults to :regular

The z label font

`zlabeloffset`

Defaults to 50

The z label offset

`zlabelrotation`

Defaults to Makie.automatic

The z label rotation in radians

`zlabelsize`

Defaults to @inherit :fontsize 16.0f0

The z label size

`zlabelvisible`

Defaults to true

Controls if the z label is visible

`zreversed`

Defaults to false

Controls if the z axis goes upwards (false) or downwards (true) in default camera orientation.

Example: `zreversed` on and off

using CairoMakie
using FileIO

fig = Figure()

brain = load(assetpath("brain.stl"))

ax1 = Axis3(fig[1, 1], title = "zreversed = false")
ax2 = Axis3(fig[2, 1], title = "zreversed = true", zreversed = true)
for ax in [ax1, ax2]
    mesh!(ax, brain, color = getindex.(brain.position, 3))
end

fig

These docs were autogenerated using Makie: v0.20.9, GLMakie: v0.9.10, CairoMakie: v0.11.10, WGLMakie: v0.9.9