Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
EXRSTDATTR(1)			 User Commands			 EXRSTDATTR(1)

NAME
       exrstdattr - set	exr image metadata

SYNOPSIS
       exrstdattr [commands] infile outfile

DESCRIPTION
       Read  OpenEXR  image file infile, set the values	of one or more attrib-
       utes in the headers of the file,	and save the result in	outfile.   In-
       file  and  outfile  must	not refer to the same file (the	program	cannot
       edit an image file "in place").

       Command for selecting headers:

       -part i

	      If i is greater than or equal to zero, and less than the	number
	      of  parts	 in the	input file, then the header for	part i becomes
	      "current." If i is "any" or -1, then all headers become current.
	      Subsequent attribute setting commands affect  only  the  current
	      header  or  headers.   All  headers are current before the first
	      -part command.

	      For example, the command sequence

       -focus 3	-part 2	-aperture 8 -expTime 0.01 -part	any -owner luke

	      sets the focus and owner attributes in all headers, as  well  as
	      the aperture and expTime attributes in the header	of part	2.

       Commands	for setting attribute values:

       -chromaticities f f f f f f f f

	      CIE xy chromaticities for	the red, green and blue	primaries, and
	      for the white point (8 floats)

       -whiteLuminance f

	      white luminance, in candelas per square meter (float, >= 0.0)

       -adoptedNeutral f f

	      CIE  xy  coordinates  that should	be considered "neutral"	during
	      color rendering.	Pixels in the image file whose xy  coordinates
	      match  the adoptedNeutral	value should be	mapped to neutral val-
	      ues on the display. (2 floats)

       -renderingTransform s

	      name of the CTL rendering	transform  for	this  image  (string).
	      This attribute is	deprecated.

       -lookModTransform s

	      name  of	the  CTL  look	modification  transform	for this image
	      (string).	This attribute is deprecated.

       -xDensity f

	      horizontal output	density, in pixels per inch (float, >= 0.0)

       -owner s

	      name of the owner	of the image (string)

       -comments s

	      additional information about the image (string)

       -capDate	s

	      date when	the image was  created	or  captured,  in  local  time
	      (string, formatted as YYYY:MM:DD hh:mm:ss)

       -utcOffset f

	      offset of	local time at capDate from UTC,	in seconds (float, UTC
	      == local time + x)

       -longitude f

       -latitude f

       -altitude f

	      location where the image was recorded, in	degrees	east of	Green-
	      wich  and	 north	of  the	equator, and in	meters above sea level
	      (float)

       -focus f

	      the camera's focus distance, in meters (float, > 0,  or  "infin-
	      ity")

       -expTime	f

	      exposure time, in	seconds	(float,	>= 0)

       -aperture f

	      lens apterture, in f-stops (float, >= 0)

       -isoSpeed f

	      effective	 speed	of  the	 film or image sensor that was used to
	      record the image (float, >= 0)

       -envmap s

	      indicates	that the image is an environment map (string,  LATLONG
	      or CUBE)

       -framesPerSecond	i i

	      playback	frame rate expressed as	a ratio	of two integers, n and
	      d	(the frame rate	is n/d frames per second)

       -keyCode	i i i i	i i i

	      key code that uniquely identifies	a motion  picture  film	 frame
	      using 7 integers:

	      *	 film  manufacturer  code (0 - 99) * film type code (0 - 99) *
	      prefix to	identify film roll (0 -	999999)	 *  count,  increments
	      once every perfsPerCount

	      perforations (0 -	9999)

	      *	offset of frame, in perforations from

	      zero-frame reference mark	(0 - 119)

	      *	number of perforations per frame (1 - 15) * number of perfora-
	      tions per	count (20 - 120)

       -timeCode i i

	      SMPTE  time  and	control	 code,	specified as a pair of 8-digit
	      base-16 integers.	 The first number contains  the	 time  address
	      and  flags  (drop	 frame,	 color frame, field/phase, bgf0, bgf1,
	      bgf2).  The second number	contains the  user  data  and  control
	      codes.

       -wrapmodes s

	      if  the  image is	used as	a texture map, specifies how the image
	      should be	extrapolated outside the zero-to-one  texture  coordi-
	      nate range (string, e.g. "clamp" or "periodic,clamp")

       -pixelAspectRatio f

	      width divided by height of a pixel (float, >= 0)

       -screenWindowWidth f

	      width of the screen window (float, >= 0)

       -screenWindowCenter f f

	      center of	the screen window (2 floats)

       -string s s

	      custom string attribute (2 strings, attribute name and value)

       -float s	f

	      custom  float  attribute	(string	 +  float,  attribute name and
	      value)

       -int s i

	      custom integer attribute (string + integer, attribute  name  and
	      value)

       Other options:

       -erase s
	      remove attribute with given name

       -h, --help
	      print this message

       --version print version information

REPORTING BUGS
       Report	   bugs	     via     https://github.com/AcademySoftwareFounda-
       tion/openexr/issues or email security@openexr.com

COPYRIGHT
       Copyright (C) Contributors to the OpenEXR Project License BSD-3-Clause

OpenEXR	3.3.3 https://openexr.com April	2025			 EXRSTDATTR(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=exrstdattr&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help