lsst.display.ds9.ds9.Buffer Class Reference

Inheritance diagram for lsst.display.ds9.ds9.Buffer:

Public Member Functions
def	__init__ (self, size=0)
def	set (self, size, silent=True)
def	pushSize (self, size=-1)
def	popSize (self)
def	flush (self, silent=True)

Detailed Description

Buffer to control sending commands to DS9.

Notes
-----
The usual usage pattern is:

>>> with ds9.Buffering():
...     # bunches of ds9.{dot,line} commands
...     ds9.flush()
...     # bunches more ds9.{dot,line} commands

Definition at line 111 of file ds9.py.

Constructor & Destructor Documentation

__init__()

def lsst.display.ds9.ds9.Buffer.__init__	(		self,
			size = 0
	)

Definition at line 124 of file ds9.py.

        def __init__(self, size=0):
            self._commands = ""         # list of pending commands
            self._lenCommands = len(self._commands)
            self._bufsize = []          # stack of bufsizes

            self._bufsize.append(size)  # don't call self.size() as ds9Cmd isn't defined yet

Member Function Documentation

flush()

def lsst.display.ds9.ds9.Buffer.flush	(		self,
			silent = True
	)

Flush the pending commands.

Parameters
----------
silent : `bool`, optional
    Do not print error messages.

Definition at line 197 of file ds9.py.

        def flush(self, silent=True):
            """Flush the pending commands.

            Parameters
            ----------
            silent : `bool`, optional
                Do not print error messages.
            """
            ds9Cmd(flush=True, silent=silent)

    cmdBuffer = Buffer(0)

popSize()

def lsst.display.ds9.ds9.Buffer.popSize

(

self

)

Switch back to the previous command buffer size.

Notes
-----
See also `pushSize`.

Definition at line 185 of file ds9.py.

        def popSize(self):
            """Switch back to the previous command buffer size.

            Notes
            -----
            See also `pushSize`.
            """
            self.flush(silent=True)

            if len(self._bufsize) > 1:
                self._bufsize.pop()

pushSize()

def lsst.display.ds9.ds9.Buffer.pushSize	(		self,
			size = -1
	)

Replace current DS9 command buffer size.

Parameters
----------
size : `int`, optional
    Size of buffer. A negative value sets the largest possible
    buffer.

Notes
-----
See also `popSize`.

Definition at line 168 of file ds9.py.

        def pushSize(self, size=-1):
            """Replace current DS9 command buffer size.

            Parameters
            ----------
            size : `int`, optional
                Size of buffer. A negative value sets the largest possible
                buffer.

            Notes
            -----
            See also `popSize`.
            """
            self.flush(silent=True)
            self._bufsize.append(0)
            self.set(size, silent=True)

set()

def lsst.display.ds9.ds9.Buffer.set	(		self,
			size,
			silent = True
	)

Set the ds9 buffer size to size.

Parameters
----------
size : `int`
    Size of buffer. Requesting a negative size provides the
    largest possible buffer given bugs in xpa.
silent : `bool`, optional
    Do not print error messages (default `True`).

Definition at line 131 of file ds9.py.

        def set(self, size, silent=True):
            """Set the ds9 buffer size to size.

            Parameters
            ----------
            size : `int`
                Size of buffer. Requesting a negative size provides the
                largest possible buffer given bugs in xpa.
            silent : `bool`, optional
                Do not print error messages (default `True`).
            """
            if size < 0:
                size = XPA_SZ_LINE - 5

            if size > XPA_SZ_LINE:
                print("xpa silently hardcodes a limit of %d for buffer sizes (you asked for %d) " %
                      (XPA_SZ_LINE, size), file=sys.stderr)
                self.set(-1)            # use max buffersize
                return

            if self._bufsize:
                self._bufsize[-1] = size  # change current value
            else:
                self._bufsize.append(size)  # there is no current value; set one

            self.flush(silent=silent)

---

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

• /j/snowflake/release/lsstsw/stack/Linux64/display_ds9/17.0.1-1-g4d4fbc4+28/python/lsst/display/ds9/ds9.py