Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ускорьте Ссылку Платформы vImage Ссылка Гистограммы

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка Гистограммы vImage

Функции гистограммы вычисляют гистограммы изображения или управляют гистограммой для изменения изображения. Существует много причин применить операции гистограммы к изображению. Изображение может не полностью использовать возможный диапазон значений интенсивности — например, большинство ее пикселей может быть довольно темным, делая подробные данные трудными видеть. Изменение изображения так, чтобы это имело более универсальную гистограмму, может улучшить контраст. Кроме того, может быть проще сравнить два изображения (относительно текстуры или других аспектов) при изменении каждой гистограммы для соответствия некоторой стандартной гистограммы.

Операции гистограммы являются операциями точки: т.е. интенсивность целевого пикселя зависит только от интенсивности исходного пикселя, измененного значениями, которые являются тем же по всему изображению. Два пикселя той же интенсивности всегда отображают на два пикселя того же (но по-видимому измененный) интенсивность. Если исходное изображение будет иметь различные значения интенсивности N, то преобразованное изображение будет иметь на большинстве различных уровней яркости N представленный.

vImage функции гистограммы или вычисляют гистограммы или выполняют одну из этих операций точки:

  • Контрастный фрагмент преобразовывает изображение так, чтобы его значения интенсивности растянулись вдоль полного спектра значений интенсивности. Это лучше всего используется на изображениях, в которых все пиксели сконцентрированы в одной области спектра интенсивности, и значения интенсивности вне той области не представлены.

  • Фрагмент концов по контрасту является более сложной версией контрастной работы фрагмента. Эти типы функций лучше всего используются на изображениях, имеющих некоторые пиксели в или около самых низких и самых высоких значений спектра интенсивности, но чья гистограмма все еще в основном сконцентрирована в одной области. Функции фрагмента концов по контрасту отображают всю интенсивность, меньше чем или равную определенному уровню к 0; вся интенсивность, больше, чем или равный определенному уровню к 255; и выполните контрастный фрагмент на всех промежуточных значениях. Низкие уровни и высокие уровни не определяются непосредственно двумя данными значениями интенсивности, но процентами: концы по контрасту простираются, работа должна счесть уровни яркости таким образом, что определенные проценты пикселей ниже одного из значений интенсивности, и определенный процент выше другого значения интенсивности

  • Коррекция преобразовывает изображение так, чтобы она имела более универсальную гистограмму. Действительно универсальная гистограмма - та, в которой каждый уровень яркости происходит с равной частотой. Эти функции, приблизительные та гистограмма.

  • Спецификация гистограммы преобразовывает изображение так, чтобы его гистограмма более близко напомнила данную гистограмму.

Функции

Протяжение контраста
  • vImageContrastStretch_ARGBFFFF (_: _: _: _: _: _: _:) vImageContrastStretch_ARGBFFFF

    Расширяет контраст исходного изображения ARGBFFFF.

    Объявление

    Swift

    func vImageContrastStretch_ARGBFFFF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageContrastStretch_ARGBFFFF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    histogram_entries

    Число записей гистограммы или стеллажи, для использования в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение, нижний уровень гистограммы. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы. Это минимальное значение применяется к каждому из четырех каналов отдельно.

    maxVal

    Максимальное пиксельное значение, верхний уровень гистограммы. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы. Это максимальное значение применяется к каждому из четырех каналов отдельно.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Контрастная работа фрагмента изменяет гистограмму изображения так, чтобы пиксельные значения могли быть сочтены и в самом низком и в самом верхнем уровне гистограммы со значениями, промежуточными «расширенными» линейным способом. Контрастная работа фрагмента сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageContrastStretch_ARGB8888 (_: _: _:) vImageContrastStretch_ARGB8888

    Расширяет контраст исходного изображения ARGB8888.

    Объявление

    Swift

    func vImageContrastStretch_ARGB8888(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageContrastStretch_ARGB8888 ( const vImage_Buffer *src, const vImage_Buffer *dest, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Контрастная работа фрагмента изменяет гистограмму изображения так, чтобы пиксельные значения могли быть сочтены и в самом низком и в самом верхнем уровне гистограммы со значениями, промежуточными «расширенными» линейным способом. Контрастная работа фрагмента сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageContrastStretch_PlanarF (_: _: _: _: _: _: _:) vImageContrastStretch_PlanarF

    Расширяет контраст исходного изображения PlanarF.

    Объявление

    Swift

    func vImageContrastStretch_PlanarF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageContrastStretch_PlanarF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    histogram_entries

    Число записей гистограммы или «стеллажи», чтобы использоваться в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение, нижний уровень гистограммы. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы.

    maxVal

    Максимальное пиксельное значение, верхний уровень гистограммы. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Контрастная работа фрагмента изменяет гистограмму изображения так, чтобы пиксельные значения могли быть сочтены и в самом низком и в самом верхнем уровне гистограммы со значениями, промежуточными «расширенными» линейным способом. Контрастная работа фрагмента сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageContrastStretch_Planar8 (_: _: _:) vImageContrastStretch_Planar8

    Расширяет контраст исходного изображения Planar8.

    Объявление

    Swift

    func vImageContrastStretch_Planar8(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageContrastStretch_Planar8 ( const vImage_Buffer *src, const vImage_Buffer *dest, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Контрастная работа фрагмента изменяет гистограмму изображения так, чтобы пиксельные значения могли быть сочтены и в самом низком и в самом верхнем уровне гистограммы со значениями, промежуточными «расширенными» линейным способом. Контрастная работа фрагмента сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageEndsInContrastStretch_ARGBFFFF (_: _: _: _: _: _: _: _: _:) vImageEndsInContrastStretch_ARGBFFFF

    Выполняет, концы по контрасту расширяют работу на исходном изображении ARGBFFFF.

    Объявление

    Swift

    func vImageEndsInContrastStretch_ARGBFFFF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ percent_low: UnsafePointer<UInt32>, _ percent_high: UnsafePointer<UInt32>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEndsInContrastStretch_ARGBFFFF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, const unsigned int percent_low[4], const unsigned int percent_high[4], unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    percent_low

    Значение процента. Число пикселей, отображающихся на самый низкий уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    percent_high

    Значение процента. Число пикселей, отображающихся на самый верхний уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    histogram_entries

    Число записей гистограммы или «стеллажи», чтобы использоваться в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение, нижний уровень гистограммы. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы. Это минимальное значение применяется к каждому из четырех каналов отдельно.

    maxVal

    Максимальное пиксельное значение, верхний уровень гистограммы. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы. Это максимальное значение применяется к каждому из четырех каналов отдельно.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Концы по контрасту простираются, работа изменяет гистограмму изображения так, чтобы определенный процент пикселей был отображен на самом низком уровне гистограммы, определенный процент отображаются на самом верхнем уровне и значениях, промежуточных «расширенный» между самым низким и самым высоким. Концы по контрасту простираются, работа сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако, размер и значения диапазона являются тем же для каждой из этих четырех гистограмм. В целом не возможно получить точно желаемый процент пикселей на нижнем уровне и верхнем уровне гистограммы преобразованного изображения. Эта работа только приближает данные значения.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageEndsInContrastStretch_ARGB8888 (_: _: _: _: _:) vImageEndsInContrastStretch_ARGB8888

    Выполняет, концы по контрасту расширяют работу на исходном изображении ARGB8888.

    Объявление

    Swift

    func vImageEndsInContrastStretch_ARGB8888(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ percent_low: UnsafePointer<UInt32>, _ percent_high: UnsafePointer<UInt32>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEndsInContrastStretch_ARGB8888 ( const vImage_Buffer *src, const vImage_Buffer *dest, const unsigned int percent_low[4], const unsigned int percent_high[4], vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    percent_low

    Значение процента. Число пикселей, отображающихся на самый низкий уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    percent_high

    Значение процента. Число пикселей, отображающихся на самый верхний уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Концы по контрасту простираются, работа изменяет гистограмму изображения так, чтобы определенный процент пикселей был отображен на самом низком уровне гистограммы, определенный процент отображаются на самом верхнем уровне и значениях, промежуточных «расширенный» между самым низким и самым высоким. Концы по контрасту простираются, работа сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако, размер и значения диапазона являются тем же для каждой из этих четырех гистограмм. В целом не возможно получить точно желаемый процент пикселей на нижнем уровне и верхнем уровне гистограммы преобразованного изображения. Эта работа только приближает данные значения.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageEndsInContrastStretch_PlanarF (_: _: _: _: _: _: _: _: _:) vImageEndsInContrastStretch_PlanarF

    Выполняет, концы по контрасту расширяют работу на исходном изображении PlanarF.

    Объявление

    Swift

    func vImageEndsInContrastStretch_PlanarF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ percent_low: UInt32, _ percent_high: UInt32, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEndsInContrastStretch_PlanarF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, unsigned int percent_low, unsigned int percent_high, unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    percent_low

    Значение процента. Число пикселей, отображающихся на самый низкий уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    percent_high

    Значение процента. Число пикселей, отображающихся на самый верхний уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    histogram_entries

    Число записей гистограммы или «стеллажи», чтобы использоваться в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение, нижний уровень гистограммы. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы.

    maxVal

    Максимальное пиксельное значение, верхний уровень гистограммы. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Концы по контрасту простираются, работа изменяет гистограмму изображения так, чтобы определенный процент пикселей был отображен на самом низком уровне гистограммы, определенный процент отображаются на самом верхнем уровне и значениях, промежуточных «расширенный» между самым низким и самым высоким. Концы по контрасту простираются, работа сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако, размер и значения диапазона являются тем же для каждой из этих четырех гистограмм. В целом не возможно получить точно желаемый процент пикселей на нижнем уровне и верхнем уровне гистограммы преобразованного изображения. Эта работа только приближает данные значения.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageEndsInContrastStretch_Planar8 (_: _: _: _: _:) vImageEndsInContrastStretch_Planar8

    Выполняет, концы по контрасту расширяют работу на исходном изображении Planar8.

    Объявление

    Swift

    func vImageEndsInContrastStretch_Planar8(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ percent_low: UInt32, _ percent_high: UInt32, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEndsInContrastStretch_Planar8 ( const vImage_Buffer *src, const vImage_Buffer *dest, unsigned int percent_low, unsigned int percent_high, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    percent_low

    Значение процента. Число пикселей, отображающихся на самый низкий уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    percent_high

    Значение процента. Число пикселей, отображающихся на самый верхний уровень гистограммы преобразованного изображения, должно представлять этот процент общих пикселей.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Концы по контрасту простираются, работа изменяет гистограмму изображения так, чтобы определенный процент пикселей был отображен на самом низком уровне гистограммы, определенный процент отображаются на самом верхнем уровне и значениях, промежуточных «расширенный» между самым низким и самым высоким. Концы по контрасту простираются, работа сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако, размер и значения диапазона являются тем же для каждой из этих четырех гистограмм. В целом не возможно получить точно желаемый процент пикселей на нижнем уровне и верхнем уровне гистограммы преобразованного изображения. Эта работа только приближает данные значения.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

Компенсация гистограммы
  • vImageEqualization_ARGBFFFF (_: _: _: _: _: _: _:) vImageEqualization_ARGBFFFF

    Компенсирует гистограмму исходного изображения ARGBFFFF.

    Объявление

    Swift

    func vImageEqualization_ARGBFFFF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEqualization_ARGBFFFF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    histogram_entries

    Число записей гистограммы или «стеллажи», чтобы использоваться в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы. Это минимальное значение применяется к каждому из четырех каналов отдельно.

    maxVal

    Максимальное пиксельное значение. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы. Это максимальное значение применяется к каждому из четырех каналов отдельно.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа коррекции изменяет гистограмму изображения так, чтобы это было ближе к универсальному распределению интенсивности. Работа коррекции гистограммы сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageEqualization_ARGB8888 (_: _: _:) vImageEqualization_ARGB8888

    Компенсирует гистограмму исходного изображения ARGB8888.

    Объявление

    Swift

    func vImageEqualization_ARGB8888(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEqualization_ARGB8888 ( const vImage_Buffer *src, const vImage_Buffer *dest, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа коррекции изменяет гистограмму изображения так, чтобы это было ближе к универсальному распределению интенсивности. Работа коррекции гистограммы сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageEqualization_PlanarF (_: _: _: _: _: _: _:) vImageEqualization_PlanarF

    Компенсирует гистограмму исходного изображения PlanarF.

    Объявление

    Swift

    func vImageEqualization_PlanarF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEqualization_PlanarF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    histogram_entries

    Число записей гистограммы или «стеллажи», чтобы использоваться в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы. Это минимальное значение применяется к каждому из четырех каналов отдельно.

    maxVal

    Максимальное пиксельное значение. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы. Это максимальное значение применяется к каждому из четырех каналов отдельно.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа коррекции изменяет гистограмму изображения так, чтобы это было ближе к универсальному распределению интенсивности. Работа коррекции гистограммы сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageEqualization_Planar8 (_: _: _:) vImageEqualization_Planar8

    Компенсирует гистограмму исходного изображения ARGB8888.

    Объявление

    Swift

    func vImageEqualization_Planar8(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageEqualization_Planar8 ( const vImage_Buffer *src, const vImage_Buffer *dest, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа коррекции изменяет гистограмму изображения так, чтобы это было ближе к универсальному распределению интенсивности. Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

Указание гистограммы
  • vImageHistogramSpecification_ARGBFFFF (_: _: _: _: _: _: _: _:) vImageHistogramSpecification_ARGBFFFF

    Выполняет работу спецификации гистограммы на исходном изображении ARGBFFFF.

    Объявление

    Swift

    func vImageHistogramSpecification_ARGBFFFF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ desiredHistogram: UnsafeMutablePointer<UnsafePointer<vImagePixelCount>>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramSpecification_ARGBFFFF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, const vImagePixelCount *desired_histogram[4], unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    desiredHistogram

    Указатель на массив четырех гистограмм, один каждый для альфы, красной, зеленой, и синей (в том порядке). Это желаемые гистограммы для преобразованного изображения. Каждая гистограмма должна быть массивом с histogram_entries элементами.

    histogram_entries

    Число записей гистограммы или «стеллажи», чтобы использоваться в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы. Это минимальное значение применяется к каждому из четырех каналов отдельно.

    maxVal

    Максимальное пиксельное значение. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы. Это максимальное значение применяется к каждому из четырех каналов отдельно.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа спецификации изменяет гистограмму изображения так, чтобы это более близко напомнило данную гистограмму. Работа спецификации гистограммы сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм, и для каждой из четырех желаемых гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageHistogramSpecification_ARGB8888 (_: _: _: _:) vImageHistogramSpecification_ARGB8888

    Выполняет работу спецификации гистограммы на исходном изображении ARGB8888.

    Объявление

    Swift

    func vImageHistogramSpecification_ARGB8888(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ desiredHistogram: UnsafeMutablePointer<UnsafePointer<vImagePixelCount>>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramSpecification_ARGB8888 ( const vImage_Buffer *src, const vImage_Buffer *dest, const vImagePixelCount *desired_histogram[4], vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    desiredHistogram

    Указатель на массив четырех гистограмм, один каждый для альфы, красной, зеленой, и синей (в том порядке). Это желаемые гистограммы для преобразованного изображения. Каждая гистограмма должна быть массивом с 256 элементами.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа спецификации изменяет гистограмму изображения так, чтобы это более близко напомнило данную гистограмму. Работа спецификации гистограммы сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм, и для каждой из четырех желаемых гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageHistogramSpecification_PlanarF (_: _: _: _: _: _: _: _:) vImageHistogramSpecification_PlanarF

    Выполняет работу спецификации гистограммы на исходном изображении PlanarF.

    Объявление

    Swift

    func vImageHistogramSpecification_PlanarF(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ tempBuffer: UnsafeMutablePointer<Void>, _ desiredHistogram: UnsafePointer<vImagePixelCount>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramSpecification_PlanarF ( const vImage_Buffer *src, const vImage_Buffer *dest, void *tempBuffer, const vImagePixelCount *desired_histogram, unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    tempBuffer

    Указатель на временный буфер. Если Вы передаете NULL, функция выделяет буфер, затем освобождает его перед возвратом. Также можно выделить буфер сами, когда Вы ответственны за освобождение его, когда Вы больше не потребность он.

    Если Вы хотите выделить буфер сами, посмотрите Обсуждение для получения информации о том, как определить минимальный размер, который необходимо выделить.

    desiredHistogram

    Указатель желаемая гистограмма для преобразованного изображения. Гистограмма должна быть массивом с histogram_entries элементы.

    histogram_entries

    Число записей гистограммы или «стеллажи», чтобы использоваться в гистограммах для этой работы.

    minVal

    Минимальное пиксельное значение. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы. Это минимальное значение применяется к каждому из четырех каналов отдельно.

    maxVal

    Максимальное пиксельное значение. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы. Это максимальное значение применяется к каждому из четырех каналов отдельно.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа спецификации изменяет гистограмму изображения так, чтобы это более близко напомнило данную гистограмму. Работа спецификации гистограммы сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм, и для каждой из четырех желаемых гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Если Вы хотите выделить память для tempBuffer параметр самостоятельно, вызовите эту функцию дважды, следующим образом:

    1. Для определения минимального размера для временного буфера в первый раз, Вы вызываете эту функциональную передачу kvImageGetTempBufferSize флаг. Передайте те же значения для всех других параметров, в которых Вы намереваетесь использовать для второго вызова. Функция возвращает требуемый минимальный размер, который должен быть положительным значением. (Отрицательное возвращенное значение указывает ошибку.) kvImageGetTempBufferSize флаг препятствует тому, чтобы функция выполнила любую обработку кроме определить минимальный размер буфера.

    2. После того, как Вы выделяете достаточно площади для буфера возвращенного размера, вызываете функцию во второй раз, передавая допустимый указатель в tempBuffer параметр. На сей раз не передавайте kvImageGetTempBufferSize флаг.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageHistogramSpecification_Planar8 (_: _: _: _:) vImageHistogramSpecification_Planar8

    Выполняет работу спецификации гистограммы на исходном изображении Planar8.

    Объявление

    Swift

    func vImageHistogramSpecification_Planar8(_ src: UnsafePointer<vImage_Buffer>, _ dest: UnsafePointer<vImage_Buffer>, _ desiredHistogram: UnsafePointer<vImagePixelCount>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramSpecification_Planar8 ( const vImage_Buffer *src, const vImage_Buffer *dest, const vImagePixelCount *desired_histogram, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    dest

    Указатель на vImage буферизует структуру данных. Вы ответственны за заполнение height, width, и rowBytes поля этой структуры, и для выделения буфера данных надлежащего размера. По возврату буфер данных, на который указывает эта структура, содержит данные конечного изображения. Когда Вам больше не нужен буфер данных, необходимо освободить память.

    desiredHistogram

    Указатель желаемая гистограмма для преобразованного изображения. Гистограмма должна быть массивом с 256 элементами.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Установите kvImageLeaveAlphaUnchanged отметьте для копирования альфа-канала в неизменное конечное изображение.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Работа спецификации изменяет гистограмму изображения так, чтобы это более близко напомнило данную гистограмму. Работа спецификации гистограммы сделана отдельно для каждого из четырех каналов — альфа, красная, зеленая, и синяя. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм, и для каждой из четырех желаемых гистограмм.

    Источник и целевые буферы должны иметь ту же высоту и ту же ширину.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

Вычисление гистограммы
  • vImageHistogramCalculation_ARGBFFFF (_: _: _: _: _: _:) vImageHistogramCalculation_ARGBFFFF

    Вычисляет гистограммы для каждого канала изображения ARGBFFFF.

    Объявление

    Swift

    func vImageHistogramCalculation_ARGBFFFF(_ src: UnsafePointer<vImage_Buffer>, _ histogram: UnsafeMutablePointer<UnsafeMutablePointer<vImagePixelCount>>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramCalculation_ARGBFFFF ( const vImage_Buffer *src, vImagePixelCount *histogram[4], unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    histogram

    Указатель на массив четырех гистограмм, один каждый для альфы, красной, зеленой, и синей (в том порядке). По возврату этот массив будет содержать эти четыре гистограммы для соответствующих каналов. Каждая из этих четырех гистограмм будет массивом с histogram_entries элементами.

    histogram_entries

    Число записей гистограммы или «стеллажи». Каждая из четырех расчетных гистограмм будет массивом с histogram_entries элементами.

    minVal

    Минимальное пиксельное значение. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы. Это минимальное значение применяется к каждому из четырех каналов отдельно.

    maxVal

    Максимальное пиксельное значение. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы. Это максимальное значение применяется к каждому из четырех каналов отдельно.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Функция вычисляет гистограмму для каждого канала полностью отдельно от других. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageHistogramCalculation_ARGB8888 (_: _: _:) vImageHistogramCalculation_ARGB8888

    Вычисляет гистограммы для каждого канала изображения ARGB8888.

    Объявление

    Swift

    func vImageHistogramCalculation_ARGB8888(_ src: UnsafePointer<vImage_Buffer>, _ histogram: UnsafeMutablePointer<UnsafeMutablePointer<vImagePixelCount>>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramCalculation_ARGB8888 ( const vImage_Buffer *src, vImagePixelCount *histogram[4], vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    histogram

    Указатель на гистограммы, один каждый для альфы, красной, зеленой, и синей (в том порядке). По возврату этот массив будет содержать эти четыре гистограммы для соответствующих каналов. Каждая из этих четырех гистограмм будет массивом с 256 элементами.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Обсуждение

    Функция вычисляет гистограмму для каждого канала полностью отдельно от других. Однако размер и значения диапазона являются тем же для каждой из этих четырех гистограмм.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageHistogramCalculation_PlanarF (_: _: _: _: _: _:) vImageHistogramCalculation_PlanarF

    Вычисляет гистограмму изображение PlanarF.

    Объявление

    Swift

    func vImageHistogramCalculation_PlanarF(_ src: UnsafePointer<vImage_Buffer>, _ histogram: UnsafeMutablePointer<vImagePixelCount>, _ histogram_entries: UInt32, _ minVal: Pixel_F, _ maxVal: Pixel_F, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramCalculation_PlanarF ( const vImage_Buffer *src, vImagePixelCount *histogram, unsigned int histogram_entries, Pixel_F minVal, Pixel_F maxVal, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    histogram

    Указатель на гистограмму. По возврату этот массив будет содержать гистограмму для исходного изображения. Гистограмма будет иметь histogram_entries элементы.

    histogram_entries

    Число записей гистограммы или «стеллажи». Гистограмма будет массивом с histogram_entries элементами.

    minVal

    Минимальное пиксельное значение. Любое пиксельное значение меньше, чем это будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено первой записи гистограммы.

    maxVal

    Максимальное пиксельное значение. Любое пиксельное значение, больше, чем это, будет отсечено к этому значению (в целях вычисления гистограммы) и присвоено последней записи гистограммы.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

  • vImageHistogramCalculation_Planar8 (_: _: _:) vImageHistogramCalculation_Planar8

    Вычисляет гистограмму для изображения Planar8.

    Объявление

    Swift

    func vImageHistogramCalculation_Planar8(_ src: UnsafePointer<vImage_Buffer>, _ histogram: UnsafeMutablePointer<vImagePixelCount>, _ flags: vImage_Flags) -> vImage_Error

    Objective C

    vImage_Error vImageHistogramCalculation_Planar8 ( const vImage_Buffer *src, vImagePixelCount *histogram, vImage_Flags flags );

    Параметры

    src

    Указатель на vImage буферизует структуру, содержащую исходное изображение.

    histogram

    Указатель на гистограмму. По возврату этот массив будет содержать гистограмму для исходного изображения. Гистограмма будет массивом с 256 элементами.

    flags

    Опции использовать. Установите kvImageDoNotTile отметьте, если Вы планируете выполнить свою собственную многопоточность мозаичного размещения или использования.

    Возвращаемое значение

    kvImageNoError, иначе это возвращает один из кодов ошибки, описанных в vImage Ссылке Типов данных и Констант.

    Оператор импорта

    Objective C

    @import Accelerate;

    Swift

    import Accelerate

    Доступность

    Доступный в OS X v10.3 и позже.

Получение минимального размера буфера.
  • vImageGetMinimumTempBufferSizeForHistogram vImageGetMinimumTempBufferSizeForHistogram (OS X v10.4)

    Возвращает минимальный размер, в байтах, для временного буфера, необходимого функции гистограммы.

    Оператор осуждения

    Используйте kvImageGetTempBufferSize флаг с надлежащей гистограммой функционирует вместо того, чтобы вызвать эту функцию.

    Объявление

    Objective C

    size_t vImageGetMinimumTempBufferSizeForHistogram ( const vImage_Buffer *src, const vImage_Buffer *dest, unsigned int histogram_entries, vImage_Flags flags, size_t bytesPerPixel );

    Параметры

    src

    Указатель на vImage буферизует структуру, которую Вы планируете передать функции гистограммы.

    dest

    Указатель на vImage буферизует структуру, которую Вы планируете передать функции гистограммы.

    histogram_entries

    Число гистограммы, которую Вы планируете передать функции гистограммы.

    flags

    Флаги, которые Вы планируете передать функции гистограммы.

    pixelBytes

    Число байтов в пикселе. Удостоверьтесь, что передали значение, подходящее для формата пикселя.

    Возвращаемое значение

    Минимальный размер, в байтах, временного буфера.

    Обсуждение

    Эта функция не зависит от data или rowBytes поля src или dest параметры; это только использует height и width поля от тех параметров. Если размер изображений, которые Вы обрабатываете, останется то же, то требуемый размер буфера также останется то же. Более в частности, если, между двумя вызовами к vImageGetMinimumTempBufferSizeForHistogram, height и width из src и dest параметры не увеличиваются, и другие параметры остаются тем же, тогда результат vImageGetMinimumTempBufferSizeForHistogram не увеличится. Это упрощает снова использовать тот же временный буфер при обработке многих изображений того же размера, как в мозаичном размещении.

    Оператор импорта

    Objective C

    @import Accelerate;

    Доступность

    Доступный в OS X v10.3 и позже.

    Осуждаемый в OS X v10.4.