This class defines Cocoa window. More...

#include <Cocoa_Window.hxx>

Inheritance diagram for Cocoa_Window:

[legend]

Public Member Functions
	Cocoa_Window (const char *const theTitle, const int thePxLeft, const int thePxTop, const int thePxWidth, const int thePxHeight)
	Creates a NSWindow and NSView defined by his position and size in pixels.

	Cocoa_Window (NSView *theViewNS)
	Creates a wrapper over existing NSView handle.

	~Cocoa_Window ()
	Destroys the Window and all resources attached to it.

virtual void	Map () const override
	Opens the window <me>

virtual void	Unmap () const override
	Closes the window <me>

virtual Aspect_TypeOfResize	DoResize () override
	Applies the resizing to the window <me>

virtual bool	DoMapping () const override
	Apply the mapping change to the window <me>

virtual bool	IsMapped () const override
	Returns True if the window <me> is opened.

virtual double	Ratio () const override
	Returns The Window RATIO equal to the physical WIDTH/HEIGHT dimensions.

virtual void	Position (int &X1, int &Y1, int &X2, int &Y2) const override
	Returns The Window POSITION in PIXEL.

virtual void	Size (int &theWidth, int &theHeight) const override
	Returns The Window SIZE in PIXEL.

NSView *	HView () const

void	SetHView (NSView *theView)
	Setup new NSView.

virtual Aspect_Drawable	NativeHandle () const override

virtual Aspect_Drawable	NativeParentHandle () const override

virtual Aspect_FBConfig	NativeFBConfig () const override
	Returns nothing on OS X.

virtual void	SetTitle (const TCollection_AsciiString &theTitle) override
	Sets window title.

virtual void	InvalidateContent (const occ::handle< Aspect_DisplayConnection > &theDisp=nullptr) override
	Invalidate entire window content by setting NSView::setNeedsDisplay property. Call will be implicitly redirected to the main thread when called from non-GUI thread.

Public Member Functions inherited from Aspect_Window
bool	IsVirtual () const
	Returns True if the window <me> is virtual.

void	SetVirtual (const bool theVirtual)
	Setup the virtual state.

NCollection_Vec2< int >	TopLeft () const
	Returns window top-left corner.

NCollection_Vec2< int >	Dimensions () const
	Returns window dimensions.

const occ::handle< Aspect_DisplayConnection > &	DisplayConnection () const
	Returns connection to Display or NULL.

Aspect_Background	Background () const
	Returns the window background.

Aspect_FillMethod	BackgroundFillMethod () const
	Returns the current image background fill mode.

Aspect_GradientBackground	GradientBackground () const
	Returns the window gradient background.

void	SetBackground (const Aspect_Background &theBack)
	Modifies the window background.

void	SetBackground (const Quantity_Color &theColor)
	Modifies the window background.

void	SetBackground (const Aspect_GradientBackground &theBackground)
	Modifies the window gradient background.

void	SetBackground (const Quantity_Color &theFirstColor, const Quantity_Color &theSecondColor, const Aspect_GradientFillMethod theFillMethod)
	Modifies the window gradient background.

virtual double	DevicePixelRatio () const
	Return device pixel ratio (logical to backing store scale factor).

virtual NCollection_Vec2< double >	ConvertPointToBacking (const NCollection_Vec2< double > &thePnt) const
	Convert point from logical units into backing store units.

virtual NCollection_Vec2< double >	ConvertPointFromBacking (const NCollection_Vec2< double > &thePnt) const
	Convert point from backing store units to logical units.

void	DumpJson (Standard_OStream &theOStream, int theDepth=-1) const
	Dumps the content of me into the stream.

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor.

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.

virtual	~Standard_Transient ()=default
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

bool	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

bool	IsInstance (const char *const theTypeName) const
	Returns a true value if this is an instance of TypeName.

bool	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

bool	IsKind (const char *const theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.

int	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object. Uses relaxed memory ordering since incrementing only requires atomicity, not synchronization with other memory operations.

int	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value. Uses release ordering for the decrement to ensure all writes to the object are visible before the count reaches zero. An acquire fence is added only when the count reaches zero, ensuring proper synchronization before deletion. This is more efficient than using acq_rel for every decrement.

virtual void	Delete () const
	Memory deallocator for transient classes.

Static Public Member Functions
static Aspect_VKey	VirtualKeyFromNative (int theKey)
	Convert Carbon virtual key into Aspect_VKey.

Static Public Member Functions inherited from Standard_Transient
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

Protected Attributes
NSWindow *	myHWindow

NSView *	myHView

int	myXLeft

int	myYTop

int	myXRight

int	myYBottom

Protected Attributes inherited from Aspect_Window
occ::handle< Aspect_DisplayConnection >	myDisplay
	Display connection.

Aspect_Background	MyBackground

Aspect_GradientBackground	MyGradientBackground

Aspect_FillMethod	MyBackgroundFillMethod

bool	MyIsVirtual

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object.

Protected Member Functions inherited from Aspect_Window
	Aspect_Window ()
	Initializes the data of a Window.

Detailed Description

This class defines Cocoa window.

Constructor & Destructor Documentation

◆ Cocoa_Window() [1/2]

Cocoa_Window::Cocoa_Window	(	const char *const	theTitle,
		const int	thePxLeft,
		const int	thePxTop,
		const int	thePxWidth,
		const int	thePxHeight )

Creates a NSWindow and NSView defined by his position and size in pixels.

◆ Cocoa_Window() [2/2]

Cocoa_Window::Cocoa_Window ( NSView * theViewNS )

Creates a wrapper over existing NSView handle.

◆ ~Cocoa_Window()

Cocoa_Window::~Cocoa_Window ( )

Destroys the Window and all resources attached to it.

Member Function Documentation

◆ DoMapping()

virtual bool Cocoa_Window::DoMapping ( ) const

overridevirtual

Apply the mapping change to the window <me>

Implements Aspect_Window.

◆ DoResize()

virtual Aspect_TypeOfResize Cocoa_Window::DoResize ( )

overridevirtual

Applies the resizing to the window <me>

Implements Aspect_Window.

◆ HView()

NSView * Cocoa_Window::HView ( ) const

inline

Returns: associated NSView

◆ InvalidateContent()

virtual void Cocoa_Window::InvalidateContent ( const occ::handle< Aspect_DisplayConnection > & theDisp = nullptr )

overridevirtual

Invalidate entire window content by setting NSView::setNeedsDisplay property. Call will be implicitly redirected to the main thread when called from non-GUI thread.

Reimplemented from Aspect_Window.

◆ IsMapped()

virtual bool Cocoa_Window::IsMapped ( ) const

overridevirtual

Returns True if the window <me> is opened.

Implements Aspect_Window.

◆ Map()

virtual void Cocoa_Window::Map ( ) const

overridevirtual

Opens the window <me>

Implements Aspect_Window.

◆ NativeFBConfig()

virtual Aspect_FBConfig Cocoa_Window::NativeFBConfig ( ) const

inlineoverridevirtual

Returns nothing on OS X.

Implements Aspect_Window.

◆ NativeHandle()

virtual Aspect_Drawable Cocoa_Window::NativeHandle ( ) const

inlineoverridevirtual

Returns: native Window handle

Implements Aspect_Window.

◆ NativeParentHandle()

virtual Aspect_Drawable Cocoa_Window::NativeParentHandle ( ) const

inlineoverridevirtual

Returns: parent of native Window handle

Implements Aspect_Window.

◆ Position()

virtual void Cocoa_Window::Position	(	int &	X1,
		int &	Y1,
		int &	X2,
		int &	Y2 ) const

overridevirtual

Returns The Window POSITION in PIXEL.

Implements Aspect_Window.

◆ Ratio()

virtual double Cocoa_Window::Ratio ( ) const

overridevirtual

Returns The Window RATIO equal to the physical WIDTH/HEIGHT dimensions.

Implements Aspect_Window.

◆ SetHView()

void Cocoa_Window::SetHView ( NSView * theView )

Setup new NSView.

◆ SetTitle()

virtual void Cocoa_Window::SetTitle ( const TCollection_AsciiString & theTitle )

overridevirtual

Sets window title.

Reimplemented from Aspect_Window.

◆ Size()

virtual void Cocoa_Window::Size	(	int &	theWidth,
		int &	theHeight ) const

overridevirtual

Returns The Window SIZE in PIXEL.

Implements Aspect_Window.

◆ Unmap()

virtual void Cocoa_Window::Unmap ( ) const

overridevirtual

Closes the window <me>

Implements Aspect_Window.

◆ VirtualKeyFromNative()

static Aspect_VKey Cocoa_Window::VirtualKeyFromNative ( int theKey )

static

Convert Carbon virtual key into Aspect_VKey.

Field Documentation

◆ myHView

NSView* Cocoa_Window::myHView

protected

◆ myHWindow

NSWindow* Cocoa_Window::myHWindow

protected

◆ myXLeft

int Cocoa_Window::myXLeft

protected

◆ myXRight

int Cocoa_Window::myXRight

protected

◆ myYBottom

int Cocoa_Window::myYBottom

protected

◆ myYTop

int Cocoa_Window::myYTop

protected

The documentation for this class was generated from the following file:

Cocoa_Window.hxx

Public Member Functions

Static Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Cocoa_Window() [1/2]

◆ Cocoa_Window() [2/2]

◆ ~Cocoa_Window()

Member Function Documentation

◆ DoMapping()

◆ DoResize()

◆ HView()

◆ InvalidateContent()

◆ IsMapped()

◆ Map()

◆ NativeFBConfig()

◆ NativeHandle()

◆ NativeParentHandle()

◆ Position()

◆ Ratio()

◆ SetHView()

◆ SetTitle()

◆ Size()

◆ Unmap()

◆ VirtualKeyFromNative()

Field Documentation

◆ myHView

◆ myHWindow

◆ myXLeft

◆ myXRight

◆ myYBottom

◆ myYTop