Skip to content

GuidelineVanishPoint3 class

Bases: pytvpaint.guideline.Guideline[pytvpaint.george.TVPGuidelineVanishPoint3, pytvpaint.george.GuidelineType]

A GuidelineVanishPoint3 is a set of points used as guideline for artists.

Source code in pytvpaint/guideline.py 
924
925
926
927
928
929
930
931
932
933
def __init__(
    self,
    position: int,
    project: Project,
    data: george.TVPGuidelineVanishPoint3 | None = None,
) -> None:
    super().__init__(position, project)
    self._data: george.TVPGuidelineVanishPoint3 = data or george.tv_guideline_modify_vanish_point_3_get(
        self._position
    )

TYPE = george.GuidelineType.VANISH_POINT_3 class-attribute instance-attribute

refresh_on_call = True instance-attribute

is_removed: bool property

Checks if the object is removed by trying to refresh its data.

Returns:

Name Type Description
bool bool

whether if it was removed or not

position: int property

The position of the guideline.

data: GuidelineDT | None property

Returns the raw data of the guideline.

project: Project property

The project instance the guideline belongs to.

name: str property writable

The name of the guideline.

is_visible: bool property writable

The guideline visibility.

margin: int property writable

The guideline margin.

color: george.RGBAColor property writable

The guideline color.

snap: bool property writable

The guideline snap state.

collapse: bool property writable

The guideline collapse state.

refresh() -> None

Refreshes the guideline data.

Source code in pytvpaint/guideline.py 
935
936
937
938
939
940
def refresh(self) -> None:
    """Refreshes the guideline data."""
    super().refresh()
    if not self.refresh_on_call and self._data:
        return
    self._data = george.tv_guideline_modify_vanish_point_3_get(self._position)

x1(value: float) -> None

Source code in pytvpaint/guideline.py 
947
948
949
@x1.setter
def x1(self, value: float) -> None:
    george.tv_guideline_modify_vanish_point_3_set(self.position, x1=value)

y1(value: float) -> None

Source code in pytvpaint/guideline.py 
956
957
958
@y1.setter
def y1(self, value: float) -> None:
    george.tv_guideline_modify_vanish_point_3_set(self.position, y1=value)

x2(value: float) -> None

Source code in pytvpaint/guideline.py 
965
966
967
@x2.setter
def x2(self, value: float) -> None:
    george.tv_guideline_modify_vanish_point_3_set(self.position, x2=value)

y2(value: float) -> None

Source code in pytvpaint/guideline.py 
974
975
976
@y2.setter
def y2(self, value: float) -> None:
    george.tv_guideline_modify_vanish_point_3_set(self.position, y2=value)

x3(value: float) -> None

Source code in pytvpaint/guideline.py 
983
984
985
@x3.setter
def x3(self, value: float) -> None:
    george.tv_guideline_modify_vanish_point_3_set(self.position, x3=value)

y3(value: float) -> None

Source code in pytvpaint/guideline.py 
992
993
994
@y3.setter
def y3(self, value: float) -> None:
    george.tv_guideline_modify_vanish_point_3_set(self.position, y3=value)

ray(value: int) -> None

Source code in pytvpaint/guideline.py 
1001
1002
1003
@ray.setter
def ray(self, value: int) -> None:
    george.tv_guideline_modify_vanish_point_3_set(self.position, ray=value)

new(project: Project, x1: float | None = None, y1: float | None = None, x2: float | None = None, y2: float | None = None, x3: float | None = None, y3: float | None = None) -> GuidelineVanishPoint3 classmethod

Create a new guideline in the project.

Source code in pytvpaint/guideline.py 
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
@classmethod
def new(
    cls,
    project: Project,
    x1: float | None = None,
    y1: float | None = None,
    x2: float | None = None,
    y2: float | None = None,
    x3: float | None = None,
    y3: float | None = None,
) -> GuidelineVanishPoint3:
    """Create a new guideline in the project."""
    project.make_current()

    position = george.tv_guideline_add_vanish_point_3(x1, y1, x2, y2, x3, y3)
    return cls(position, project)

remove() -> None

Remove the guideline.

Warning

the guideline instance won't be usable after removal

Source code in pytvpaint/guideline.py 
151
152
153
154
155
156
157
158
159
def remove(self) -> None:
    """Remove the guideline.

    Warning:
        the guideline instance won't be usable after removal
    """
    if self.TYPE:
        george.tv_guideline_remove(self.position, self.TYPE)
    self.mark_removed()

mark_removed() -> None

Marks the object as removed and is therefor not usable.

Source code in pytvpaint/utils.py 
 98
 99
100
def mark_removed(self) -> None:
    """Marks the object as removed and is therefor not usable."""
    self._is_removed = True

set_all_visible(value: bool) -> None classmethod

Set visibility state on all guidelines.

Source code in pytvpaint/guideline.py 
121
122
123
124
@classmethod
def set_all_visible(cls, value: bool) -> None:
    """Set visibility state on all guidelines."""
    george.tv_guideline_visibility_set_all(cls.TYPE, value)

set_all_margin(value: int) -> None classmethod

Set the margin on all guidelines.

Source code in pytvpaint/guideline.py 
126
127
128
129
@classmethod
def set_all_margin(cls, value: int) -> None:
    """Set the margin on all guidelines."""
    george.tv_guideline_margin_set_all(cls.TYPE, value)

set_all_color(value: george.RGBAColor) -> None classmethod

Set the color on all guidelines.

Source code in pytvpaint/guideline.py 
131
132
133
134
@classmethod
def set_all_color(cls, value: george.RGBAColor) -> None:
    """Set the color on all guidelines."""
    george.tv_guideline_color_set_all(cls.TYPE, value)

set_all_snap(value: bool) -> None classmethod

Set the snap state on all guidelines.

Source code in pytvpaint/guideline.py 
136
137
138
139
@classmethod
def set_all_snap(cls, value: bool) -> None:
    """Set the snap state on all guidelines."""
    george.tv_guideline_snap_set_all(cls.TYPE, value)

set_global_visible(value: bool) -> None staticmethod

Set the visibility on the global guideline.

Source code in pytvpaint/guideline.py 
141
142
143
144
@staticmethod
def set_global_visible(value: bool) -> None:
    """Set the visibility on the global guideline."""
    george.tv_guideline_visibility_set(0, value, on_global=True)

set_global_snap(value: bool) -> None staticmethod

Set snap state on the global guideline.

Source code in pytvpaint/guideline.py 
146
147
148
149
@staticmethod
def set_global_snap(value: bool) -> None:
    """Set snap state on the global guideline."""
    george.tv_guideline_snap_set(0, value, on_global=True)