TargetCustom
extends Target
in package
This class holds a pointer to a VipsObject (the libvips base class) and manages properties.
Table of Contents
Properties
- $check_max_stack_size : bool
- libvips executes FFI callbacks off the main thread and this confuses the stack limit checks available since PHP 8.3.0. We need to check if `zend.max_allowed_stack_size` is set to `-1`.
Methods
- __clone() : mixed
- __construct() : mixed
- __destruct() : mixed
- filename() : string|null
- Get the filename associated with a connection. Return null if there is no associated file.
- get() : mixed
- getArgumentDescription() : string
- getBlurb() : string
- getDescription() : string
- getPspec() : CData|null
- getType() : int
- newToDescriptor() : self
- Make a new target to write to a file descriptor. For example:
- newToFile() : self
- Make a new target to write to a filename. For example:
- newToMemory() : self
- Make a new target to write to a memory buffer. For example:
- nick() : string|null
- Make a human-readable name for a connection suitable for error messages.
- onEnd() : void
- Attach an end handler.
- onFinish() : void
- Attach a finish handler.
- onRead() : void
- Attach a read handler.
- onSeek() : void
- Attach a seek handler.
- onWrite() : void
- Attach a write handler.
- printAll() : void
- ref() : void
- set() : void
- setString() : bool
- signalConnect() : void
- Connect to a signal on this object.
- unref() : void
- unrefOutputs() : void
- getMarshaler() : Closure|null
Properties
$check_max_stack_size
libvips executes FFI callbacks off the main thread and this confuses the stack limit checks available since PHP 8.3.0. We need to check if `zend.max_allowed_stack_size` is set to `-1`.
private
static bool
$check_max_stack_size
= true
See: https://github.com/libvips/php-vips/pull/237.
Methods
__clone()
public
__clone() : mixed
__construct()
public
__construct() : mixed
__destruct()
public
__destruct() : mixed
filename()
Get the filename associated with a connection. Return null if there is no associated file.
public
filename() : string|null
Return values
string|nullget()
public
get(string $name) : mixed
Parameters
- $name : string
Tags
getArgumentDescription()
public
getArgumentDescription(string $name) : string
Parameters
- $name : string
Return values
stringgetBlurb()
public
getBlurb(string $name) : string
Parameters
- $name : string
Return values
stringgetDescription()
public
getDescription() : string
Return values
stringgetPspec()
public
getPspec(string $name) : CData|null
Parameters
- $name : string
Return values
CData|nullgetType()
public
getType(string $name) : int
Parameters
- $name : string
Return values
intnewToDescriptor()
Make a new target to write to a file descriptor. For example:
public
static newToDescriptor(int $descriptor) : self
$target = Target::newToDescriptor(1);
Makes a descriptor attached to stdout. You can pass this target to (for example) @see Image::writeToTarget()
Parameters
- $descriptor : int
Tags
Return values
selfnewToFile()
Make a new target to write to a filename. For example:
public
static newToFile(string $filename) : self
$target = Target::newToFile("myfile.jpg");
You can pass this target to (for example) @see Image::writeToTarget()
Parameters
- $filename : string
Tags
Return values
selfnewToMemory()
Make a new target to write to a memory buffer. For example:
public
static newToMemory() : self
$target = Target::newToMemory();
You can pass this target to (for example) @see Image::writeToTarget()
Tags
Return values
selfnick()
Make a human-readable name for a connection suitable for error messages.
public
nick() : string|null
Return values
string|nullonEnd()
Attach an end handler.
public
onEnd(callable $callback) : void
This optional handler is called at the end of write. It should do any cleaning up necessary, and return 0 on success and -1 on error.
Automatically falls back to onFinish if libvips <8.13.
Parameters
- $callback : callable
Tags
onFinish()
Attach a finish handler.
public
onFinish(callable $callback) : void
For libvips 8.13 and later, this method is deprecated in favour of onEnd().
Parameters
- $callback : callable
Tags
onRead()
Attach a read handler.
public
onRead(callable $callback) : void
The interface is similar to fread(). The handler is given a number of bytes to fetch, and should return a bytes-like object containing up to that number of bytes. If there is no more data available, it should return null.
Read handlers on VipsTarget are optional. If you do not set one, your target will be treated as unreadable and libvips will be unable to write some file types (just TIFF, as of the time of writing).
Parameters
- $callback : callable
onSeek()
Attach a seek handler.
public
onSeek(callable $callback) : void
The interface is similar to fseek, so the handler is passed parameters for $offset and $whence with the same meanings. However, the handler MUST return the new seek position. A simple way to do this is to call ftell() and return that result.
Seek handlers are optional. If you do not set one, your source will be treated as unseekable and libvips will do extra caching.
$whence in particular:
- 0 => start
- 1 => current position
- 2 => end
Parameters
- $callback : callable
onWrite()
Attach a write handler.
public
onWrite(callable $callback) : void
The interface is similar to fwrite(). The handler is given a bytes-like object to write, and should return the number of bytes written.
Unlike fwrite, you should return -1 on error.
Parameters
- $callback : callable
Tags
printAll()
public
static printAll() : void
ref()
public
ref() : void
set()
public
set(string $name, mixed $value) : void
Parameters
- $name : string
- $value : mixed
Tags
setString()
public
setString(string $string_options) : bool
Parameters
- $string_options : string
Return values
boolsignalConnect()
Connect to a signal on this object.
public
signalConnect(string $name, callable $callback) : void
The callback will be triggered every time this signal is issued on this instance.
Parameters
- $name : string
- $callback : callable
Tags
unref()
public
unref() : void
unrefOutputs()
public
unrefOutputs() : void
getMarshaler()
private
static getMarshaler(string $name, callable $callback) : Closure|null
Parameters
- $name : string
- $callback : callable