Volume
class Volume extends Model
A volume is a collection of images. Volumes belong to one or many projects.
Traits
Constants
| IMAGE_FILE_REGEX |
Regular expression that matches the supported image file extensions. This regex allows optional HTTP query parameters after the file names, too. Example "image.jpg?raw=1". This may be required for remote images with services like Dropbox. |
| VIDEO_FILE_REGEX |
Regular expression that matches the supported video file extensions. This regex allows optional HTTP query parameters after the file names, too. Example "video.mp4?raw=1". This may be required for remote files with services like Dropbox. |
Properties
| $hidden | The attributes hidden from the model's JSON form. |
||
| protected array | $casts | The attributes that should be casted to native types. |
Methods
Set a dynamic JSON attribute.
Get a dynamic JSON attribute.
Parses a comma separated list of filenames to an array.
Scope a query to all volumes that are accessible by a user.
The user that created the volume.
The media type of this volume.
The images belonging to this volume.
The videos belonging to this volume.
The images or videos belonging to this volume.
The images belonging to this volume ordered by filename (ascending).
Return a query for all users associated to this volume through projects.
The project(s), this volume belongs to.
The annotation sessions of this volume.
The active annotation sessions of this volume (if any).
Returns the active annotation session of this volume for the given user.
Check if the given annotation session is in conflict with existing ones.
Check if the images of this volume come from a remote URL.
An image that can be used as unique thumbnail for this volume.
URL to the thumbnail image of this volume.
Several images or videos that can be used for the preview thumbnail of a volume.
URLs to the thumbnail images of this volume.
Flush the cache that stores the volume thumbnail.
Check if the volume has some images with GPS coordinates.
Flush the cached information if this volume has images with GPS coordinates.
Set the url attribute of this volume.
Set the creating_async attribute of this volume.
Get the creating_async attribute of this volume.
Check if the there are tiled images in this volume.
Specifies whether the volume is an image volume.
Specifies whether the volume is a video volume.
Save an iFDO metadata file and link it with this volume.
Check if an iFDO metadata file is available for this volume.
Delete the iFDO metadata file linked with this volume.
Download the iFDO that is attached to this volume.
Get the content of the iFDO file associated with this volume.
Get the filename of the volume iFDO in storage.
Get the cache key for volume thumbnails.
Get the cache key for volume geo info.
Get the cache key for volume iFDO info.
Details
in
HasJsonAttributes at line 16
protected
setJsonAttr(string $key, mixed $value, string $attrs = 'attrs')
Set a dynamic JSON attribute.
in
HasJsonAttributes at line 38
protected mixed
getJsonAttr(string $key, mixed $default = null, string $attrs = 'attrs')
Get a dynamic JSON attribute.
at line 71
static array
parseFilesQueryString(string $string)
Parses a comma separated list of filenames to an array.
at line 85
Builder
scopeAccessibleBy(Builder $query, User $user)
Scope a query to all volumes that are accessible by a user.
at line 105
BelongsTo
creator()
The user that created the volume.
at line 115
BelongsTo
mediaType()
The media type of this volume.
at line 125
HasMany
images()
The images belonging to this volume.
at line 135
HasMany
videos()
The videos belonging to this volume.
at line 145
HasMany
files()
The images or videos belonging to this volume.
at line 160
HasMany
orderedImages()
deprecated
deprecated
The images belonging to this volume ordered by filename (ascending).
at line 170
HasMany
orderedFiles()
The images belonging to this volume ordered by filename (ascending).
at line 180
Builder
users()
Return a query for all users associated to this volume through projects.
at line 199
BelongsToMany
projects()
The project(s), this volume belongs to.
at line 209
HasMany
annotationSessions()
The annotation sessions of this volume.
at line 219
HasOne
activeAnnotationSession()
The active annotation sessions of this volume (if any).
at line 239
AnnotationSession
getActiveAnnotationSession(User $user)
Returns the active annotation session of this volume for the given user.
An annotation session may be active for a volume but it is only also active for a user, if the user belongs to the set of restricted users of the annotation session.
at line 259
bool
hasConflictingAnnotationSession(AnnotationSession $session)
Check if the given annotation session is in conflict with existing ones.
A conflict exists if the active time period of two sessions overlaps.
at line 286
bool
isRemote()
Check if the images of this volume come from a remote URL.
at line 296
Image
getThumbnailAttribute()
An image that can be used as unique thumbnail for this volume.
at line 308
string
getThumbnailUrlAttribute()
URL to the thumbnail image of this volume.
at line 318
Collection
getThumbnailsAttribute()
Several images or videos that can be used for the preview thumbnail of a volume.
at line 342
array
getThumbnailsUrlAttribute()
URLs to the thumbnail images of this volume.
at line 350
flushThumbnailCache()
Flush the cache that stores the volume thumbnail.
at line 360
bool
hasGeoInfo()
Check if the volume has some images with GPS coordinates.
at line 368
flushGeoInfoCache()
Flush the cached information if this volume has images with GPS coordinates.
at line 381
setUrlAttribute(string $value)
Set the url attribute of this volume.
at line 396
setCreatingAsyncAttribute(string $value)
Set the creating_async attribute of this volume.
at line 408
string
getCreatingAsyncAttribute()
Get the creating_async attribute of this volume.
at line 418
bool
hasTiledImages()
Check if the there are tiled images in this volume.
at line 429
bool
isImageVolume()
Specifies whether the volume is an image volume.
at line 439
bool
isVideoVolume()
Specifies whether the volume is a video volume.
at line 450
saveIfdo(UploadedFile $file)
Save an iFDO metadata file and link it with this volume.
at line 463
bool
hasIfdo(bool $ignoreErrors = false)
Check if an iFDO metadata file is available for this volume.
at line 479
deleteIfdo()
Delete the iFDO metadata file linked with this volume.
at line 490
Response
downloadIfdo()
Download the iFDO that is attached to this volume.
at line 506
array
getIfdo()
Get the content of the iFDO file associated with this volume.
at line 518
protected string
getIfdoFilename()
Get the filename of the volume iFDO in storage.
at line 528
protected string
getThumbnailsCacheKey()
Get the cache key for volume thumbnails.
at line 538
protected string
getGeoInfoCacheKey()
Get the cache key for volume geo info.
at line 548
protected string
getIfdoCacheKey()
Get the cache key for volume iFDO info.