Verschiedenes

Dieser Funktion kommt in Contentpapst besondere Bedeutung zu. Mit "cp_clean_wysiwyg()" lässt sich ein per Variable übergebener Text aus dem WYSIWYG-Editor standardkonform aufbereiten. Es wird versucht, alle HTML-Tags in das XHTML-Format zu konvertieren.

Verschiedene Dateigrößen können mit dieser Funktion in ein anderes Format konvertiert werden. Der Funktion wird neben der Dateigröße in Bytes das gewünschte Zielformat (KB, MB, GB, TB, PB, EB) sowie optional die Anzahl der Dezimalstellen übergeben.

Die Funktion "cp_extract_exif()" extrahiert die EXIF-Informationen in einer JPEG- oder TIFF-Datei und gibt diese als assoziatives Array zurück. EXIF enthält wichtige Angaben zu Grafiken wie die Bittiefe, die Verschlussgeschwindigkeit und das Erstellungsprogramm. Diese Angaben sind nicht immer zwingend für eine Grafik erforderlich und können daher variabel ausfallen.

EXIF-Informationen werden meist von Digitalkameras in die Grafiken eingefügt, damit eine weitergehende Anpassung der Grafiken anhand der Einstellungen bei der Aufnahme vorgenommen werden kann. Damit die Funktion arbeiten kann, wird ihr ein Dateiname samt Pfad ausgehend vom Contentpapst-Verzeichnis übergeben. Zurückgegeben werden folgende Angaben, sofern diese in einer Datei vorhanden sind:

Zurückgelieferte EXIF-Informationen (soweit enthalten)
aperture_fnumber		Blendeneinstellung
aperture_value		Blenden-Wert in APEX
artist		Autor/Artist
brightness_value		Helligkeitswert der Grafik in APEX
color_space		Farbraum / Bittiefe des Bildes
copyright		Copyright-Informationen
date		Datum der Erstellung
date_time		Datum/Zeit der letzten Änderung
date_time_digitized		Datum/Uhrzeit der Digitalisierung
date_time_original		Datum/Uhrzeit des Originals
description		Beschreibung der Grafik
exif_image_length		Größe der EXIF-Grafik
exif_image_width		Größe der EXIF-Grafik
exif_version		Verwendete Version der EXIF-Spezifikation
exposure_bias_value		Exposure Bias-Wert in APEX
exposure_program		Genutztes Programm für die Datei
exposure_time		Verschlussgeschwindigkeit
file_source		Quelle der Datei (Digitalkamera etc.)
flash		Blitzlicht (0 = kein Blitzlicht, >= 1 = Blitzlicht)
flash_pix_version		Verwendete FlashPix-Version
fnumber		F-number (F-stop)
focal_length		Brennweite in Millimeter
focal_plane_resolution_unit		Abmessungen der Brennebene (1 = keine Einheit, 2 = Inch, 3 = Zentimeter)
focal_plane_x_resolution		Horizontale Auflösung der Brennebene
focal_plane_y_resolution		Vertikale Auflösung der Brenneben
height		Höhe der Grafik
is_color		Farbbild (0 = Nein, 1 = Ja)
iso_speed_ratings		Äquivalent zum CCD Index
make		Hersteller der Digitalkamera
metering_mode		Modus der Entfernungsmessung
mime_type		MIME-Type (z.B. "image/jpeg")
model		Modellbezeichnung der Digitalkamera
name		Name der Datei ohne Pfadangaben
orientation		Ausrichtung (1 = oben links, 2 = oben rechts usw.)
resolution_unit		Abmessungen (1 = keine Einheit, 2 = Inch, 3 = Zentimeter)
scene_type		Typ der Szene (direkt aufgenommen etc.)
sensing_method		Typ des genutzten Sensors der Digitalkamera
shutter_speed_value		Verschlussgeschwindigkeit in APEX
size		Größe in Bytes
size_formatted		Größe in MB umgerechnet
software		Software der Digitalkamera bzw. Bildbearbeitungsprogramm
status		Error-Code der Datei (1 = alles OK, 2 = Datei nicht vorhanden, 3 = falscher Dateityp, 4 = keine EXIF-Unterstützung vorhanden)
type		Dateityp
x_resolution		Breite der Grafik für den Druck (meist in Inch)
y_resolution		Höhe der Grafik für den Druck (meist in Inch)
width		Breite der Grafik
ycbcr_positioning		Positionierung der "YCbCr"-Elemente

Weitere Angaben können je nach Modell der Digitalkamera zurückgegeben werden, sind jedoch nicht standardisiert und daher nicht immer verlässlich.

Die Funktion "cp_extract_id3()" extrahiert die ID3- bzw. ID3v2-Informationen in einer MP3-Datei und gibt diese als assoziatives Array zurück. ID3/ID3v2 enthält wichtige Angaben zum Musikstück wie die Dauer, die Abtastrate und Bitrate, MPEG-Version und MPEG-Layer, aber auch zusätzliche Angaben wie Autor, Titel, einen Kommentar usw.

Damit die Funktion arbeiten kann, wird ihr ein Dateiname samt Pfad ausgehend vom Contentpapst-Verzeichnis übergeben. Zurückgegeben werden folgende Angaben, sofern diese in einer Datei vorhanden sind:

Zurückgelieferte ID3- bzw. ID3v2-Informationen (soweit enthalten)
album		Album, aus dem die Datei stammt
artist		Autor/Artist des Musikstückes
bitrate		Bitrate der Datei in kBit/s
comment		Kommentar zum Musikstück
copyright		Copyright-Informationen (-1 = Nicht geschützt, 1 = Geschützt)
emphasis		Betonung des Musikstückes (keine einheitliche Nutzung)
framerate		Anzahl der Datenblöcke in der Datei
genre		Genre-Nummer
genre_name		Name des Genres
length		Gesamte Spieldauer in Sekunden
length_formatted		Spieldauer in lesbarer Form mit Minuten und Sekunden
length_minutes		Verbleibende Minuten der Spieldauer
length_seconds		Verbleibende Sekunden der Spieldauer
mode		Anzahl der genutzten Kanäle ("Stereo", "Joint-Stereo", "Dual-Channel" oder "Mono")
mode_extension		Nicht genutztes Bit
mpeg_layer		Der genutzte MPEG-Layer (Layer I/II/III)
mpeg_version		MPEG-Version der Datei (MPEG 1/2)
name		Name des Musikstückes ohne Pfadangaben
original_home		Modus (0 = Kopie, 1 = Original)
padding_bit		Dient der Berechnung der Frame-Anzahl
private_bit		Bit zur privaten Verfügung in einer Datei
protection_bit		Schutz-Bit am Anfang einer Datei (0 = Deaktiviert, 1 = Aktiviert)
sampling_frequenze		Abtastrate in Hz
size		Größe in Bytes
size_formatted		Größe in MB umgerechnet
status		Error-Code der Datei (1 = alles OK, 2 = Datei nicht vorhanden, 3 = falscher Dateityp)
syncword		Synchronisierungs-Bits am Anfang einer Datei
time		Erstellungsdatum der Datei
title		Songtitel

IPTC ist ein Standard der "International Press Telecommunications Council" und erlaubt die zusätzliche Integration von beschreibenden Informationen in den Kopf-Bereich einer JPEG-Datei. Die Funktion "cp_extract_iptc()" extrahiert diese Informationen und gibt diese als assoziatives Array zurück. Die Angaben sind nicht immer zwingend für eine Grafik erforderlich und können daher variabel ausfallen.

Damit die Funktion arbeiten kann, wird ihr ein Dateiname samt Pfad ausgehend vom Contentpapst-Verzeichnis übergeben. Zurückgegeben werden folgende Angaben, sofern diese in einer Datei vorhanden sind:

Zurückgelieferte IPTC-Informationen (soweit enthalten)
author		Autor
author_description		Autor der Beschreibung
caption		Bildbeschreibung
category		Kategorie
city		Stadt
copyright_notice		Copyright-Informationen
country		Land
creation_date		Erstellungsdatum
credit_byline_title		Position des Autors
headline		Überschrift
height		Höhe der Grafik
keywords		Stichwörter
name		Name der Grafik ohne Pfadangaben
otr		Aufgeber-Code
photo_source		Quelle
priority		Dringlichkeit
size		Größe in Bytes
size_formatted		Größe in MB umgerechnet
source		Bildrechte
spec_instr		Anweisungen
state		Bundesland
status		Error-Code der Datei (1 = alles OK, 2 = Datei nicht vorhanden)
supplemental_category		Ergänzende Kategorie
title		Bildtitel
width		Breite der Grafik