README

警告：此库为预alpha版，大部分功能仍在开发中或完全不工作。请自行承担风险。

支持的图像类型

• JPEG
• PNG
• GIF
• PDF
• SVG
• WEBP
• TIFF
• DNG
• RAW 格式 - CR2, NEF 等。

支持的图像元数据类型

• XMP
• IPTC
• EXIF

获取元数据

$image = Image::fromFile($filename);

$headline = $image->getXmp()->getHeadline();
$camera = $image->getExif()->getCamera();
...

修改现有元数据

$image = Image::fromFile($filename);

$xmp = $image->getXmp();
$xmp->setHeadline('A test headline');
$xmp->setCaption('Caption');

$image->getIptc()->setCategory('Category');

$image->save();

独立的 XMP

生成独立的 XMP

$xmp = new Xmp;
$xmp->setHeadline('A headline')
...

$data = $xmp->getXml();

修改独立的 XMP

$xmp = new Xmp($data); // or Xmp::fromFile($filename)
$xmp->setHeadline('A headline');

$data = $xmp->getXml();

设置/替换图像中的 XMP

$xmp = new Xmp;
$xmp->setHeadline('A headline');
...

$image = Image::fromFile($filename);
$image->setXmp($xmp);

$image->save() // or $image->getBytes()

加载特定图像类型

当已知文件类型时，您可以直接使用文件类型的 fromFile 方法加载文件类型。

$jpeg = JPEG::fromFile('image.jpg');
$png = PNG::fromFile('image.png');

从字节实例化

如果您没有文件可工作，但您有一个存储在字符串中的图像（来自数据库、ImageMagick 等），您可以从字符串轻松实例化一个对象。

$data = ...

$jpeg = JPEG::fromString($data);
$jpeg->getXmp()->setHeadline('Test headline');

$jpeg->save('out.jpg'); // or $jpeg->getBytes();

从 GD 或流实例化

您也可以从 GD 资源或流创建对象。

$gd = imagecreate(100, 100);
$jpeg = JPEG::fromResource($gd);

$stream = fopen('...', 'r+');
$jpeg = JPEG::fromStream($stream);

聚合元数据

当只想获取一部分元数据而不关心它是来自 XMP、IPTC 还是 EXIF 时，您可以使用聚合元数据对象。

$image = Image::fromFile($filename);
$headline = $image->getAggregate()->getHeadline();

默认情况下，它首先检查 XMP，然后是 IPTC，然后是 EXIF，但您可以更改优先级。

$aggregate = $image->getAggregate();
$aggregate->setPriority(['exif', 'iptc', 'xmp']);

$aggregate->getHeadline(); // will now check EXIF first, then IPTC, then XMP

您也可以排除不使用的元数据类型

$aggregate->setPriority(['iptc', 'xmp']);
$aggregate->getHeadline(); // will only check IPTC and XMP

您还可以在聚合级别上修改元数据

$image = Image::fromFile($filename);
$image->getAggregate()->setHeadline('Headline');

$image->save();

这将同时在 XMP 和 IPTC 中设置标题。为了与其他软件的最大兼容性，建议在可用时使用聚合元数据对象。

获取 GPS 数据

$image = ...
$gps = $image->getAggregateMeta()->getGPS(); // checks EXIF and XMP
// or $gps = $image->getExif()->getGPS();

$lat = $gps->getLatitude();