WebP API ডকুমেন্টেশন

এই বিভাগটি WebP লাইব্রেরিতে অন্তর্ভুক্ত এনকোডার এবং ডিকোডারের API বর্ণনা করে। এই API বিবরণটি সংস্করণ 1.4.0 এর সাথে সম্পর্কিত।

হেডার এবং লাইব্রেরি

আপনি যখন libwebp ইনস্টল করবেন , আপনার প্ল্যাটফর্মের জন্য সাধারণ অবস্থানে webp/ নামে একটি ডিরেক্টরি ইনস্টল করা হবে। উদাহরণস্বরূপ, ইউনিক্স প্ল্যাটফর্মে, নিম্নলিখিত হেডার ফাইলগুলি /usr/local/include/webp/ এ কপি করা হবে।

decode.h
encode.h
types.h

লাইব্রেরিগুলি সাধারণ লাইব্রেরি ডিরেক্টরিতে অবস্থিত। স্ট্যাটিক এবং ডাইনামিক লাইব্রেরিগুলি ইউনিক্স প্ল্যাটফর্মে /usr/local/lib/ এ রয়েছে।

সহজ ডিকোডিং API

ডিকোডিং API ব্যবহার শুরু করতে, আপনাকে অবশ্যই নিশ্চিত করতে হবে যে আপনার কাছে উপরে বর্ণিত লাইব্রেরি এবং হেডার ফাইলগুলি ইনস্টল করা আছে।

আপনার C/C++ কোডে ডিকোডিং API শিরোনামটি নিম্নরূপ অন্তর্ভুক্ত করুন:

#include "webp/decode.h"
int WebPGetInfo(const uint8_t* data, size_t data_size, int* width, int* height);

এই ফাংশনটি WebP ছবির হেডার যাচাই করবে এবং ছবির প্রস্থ এবং উচ্চতা পুনরুদ্ধার করবে। পয়েন্টার *width এবং *height অপ্রাসঙ্গিক মনে হলে NULL পাস করা যেতে পারে।

ইনপুট বৈশিষ্ট্য

তথ্য
WebP ইমেজ ডেটা পয়েন্টার
ডেটা_সাইজ
এটি ইমেজ ডেটা ধারণকারী data দ্বারা নির্দেশিত মেমরি ব্লকের আকার।

রিটার্নস

মিথ্যা
(a) ফরম্যাটিং ত্রুটি(গুলি) এর ক্ষেত্রে ত্রুটি কোড ফিরে এসেছে।
সত্য
সাফল্যের উপর। *width এবং *height শুধুমাত্র সফল রিটার্নের ক্ষেত্রে বৈধ।
প্রস্থ
পূর্ণসংখ্যার মান। পরিসীমা 1 থেকে 16383 পর্যন্ত সীমাবদ্ধ।
উচ্চতা
পূর্ণসংখ্যার মান। পরিসীমা 1 থেকে 16383 পর্যন্ত সীমাবদ্ধ।
struct WebPBitstreamFeatures {
  int width;          // Width in pixels.
  int height;         // Height in pixels.
  int has_alpha;      // True if the bitstream contains an alpha channel.
  int has_animation;  // True if the bitstream is an animation.
  int format;         // 0 = undefined (/mixed), 1 = lossy, 2 = lossless
}

VP8StatusCode WebPGetFeatures(const uint8_t* data,
                              size_t data_size,
                              WebPBitstreamFeatures* features);

এই ফাংশনটি বিটস্ট্রিম থেকে বৈশিষ্ট্যগুলি পুনরুদ্ধার করবে। *features কাঠামো বিটস্ট্রিম থেকে সংগৃহীত তথ্যে পূর্ণ:

ইনপুট বৈশিষ্ট্য

তথ্য
WebP ইমেজ ডেটা পয়েন্টার
ডেটা_সাইজ
এটি ইমেজ ডেটা ধারণকারী data দ্বারা নির্দেশিত মেমরি ব্লকের আকার।

রিটার্নস

VP8_STATUS_OK
যখন বৈশিষ্ট্যগুলি সফলভাবে পুনরুদ্ধার করা হয়।
VP8_STATUS_NOT_ENOUGH_DATA
যখন শিরোনাম থেকে বৈশিষ্ট্য পুনরুদ্ধার করার জন্য আরও ডেটা প্রয়োজন হয়।

অন্যান্য ক্ষেত্রে অতিরিক্ত VP8StatusCode ত্রুটির মান।

বৈশিষ্ট্য
WebPBitstream বৈশিষ্ট্য কাঠামোর নির্দেশক।
uint8_t* WebPDecodeRGBA(const uint8_t* data, size_t data_size, int* width, int* height);
uint8_t* WebPDecodeARGB(const uint8_t* data, size_t data_size, int* width, int* height);
uint8_t* WebPDecodeBGRA(const uint8_t* data, size_t data_size, int* width, int* height);
uint8_t* WebPDecodeRGB(const uint8_t* data, size_t data_size, int* width, int* height);
uint8_t* WebPDecodeBGR(const uint8_t* data, size_t data_size, int* width, int* height);

এই ফাংশনগুলি data দ্বারা নির্দেশিত একটি WebP চিত্রকে ডিকোড করে৷

  • WebPDecodeRGBA [r0, g0, b0, a0, r1, g1, b1, a1, ...] ক্রমে RGBA ছবির নমুনা প্রদান করে।
  • WebPDecodeARGB [a0, r0, g0, b0, a1, r1, g1, b1, ...] ক্রমে ARGB ছবির নমুনা প্রদান করে।
  • WebPDecodeBGRA [b0, g0, r0, a0, b1, g1, r1, a1, ...] ক্রমে BGRA ছবির নমুনা প্রদান করে।
  • WebPDecodeRGB [r0, g0, b0, r1, g1, b1, ...] ক্রমে RGB ছবির নমুনা প্রদান করে।
  • WebPDecodeBGR [b0, g0, r0, b1, g1, r1, ...] অর্ডারে BGR ছবির নমুনা প্রদান করে।

যে কোডটি এই ফাংশনগুলির যেকোনো একটিকে কল করে তা অবশ্যই WebPFree() এর সাথে এই ফাংশনগুলির দ্বারা ফিরে আসা ডেটা বাফার (uint8_t*) মুছে ফেলতে হবে।

ইনপুট বৈশিষ্ট্য

তথ্য
WebP ইমেজ ডেটা পয়েন্টার
ডেটা_সাইজ
এটি ইমেজ ডেটা ধারণকারী data দ্বারা নির্দেশিত মেমরি ব্লকের আকার
প্রস্থ
পূর্ণসংখ্যার মান। পরিসীমা বর্তমানে 1 থেকে 16383 পর্যন্ত সীমাবদ্ধ।
উচ্চতা
পূর্ণসংখ্যার মান। পরিসীমা বর্তমানে 1 থেকে 16383 পর্যন্ত সীমাবদ্ধ।

রিটার্নস

uint8_t*
রৈখিক RGBA/ARGB/BGRA/RGB/BGR ক্রমানুসারে ডিকোড করা WebP ছবির নমুনার পয়েন্টার।
uint8_t* WebPDecodeRGBAInto(const uint8_t* data, size_t data_size,
                            uint8_t* output_buffer, int output_buffer_size, int output_stride);
uint8_t* WebPDecodeARGBInto(const uint8_t* data, size_t data_size,
                            uint8_t* output_buffer, int output_buffer_size, int output_stride);
uint8_t* WebPDecodeBGRAInto(const uint8_t* data, size_t data_size,
                            uint8_t* output_buffer, int output_buffer_size, int output_stride);
uint8_t* WebPDecodeRGBInto(const uint8_t* data, size_t data_size,
                           uint8_t* output_buffer, int output_buffer_size, int output_stride);
uint8_t* WebPDecodeBGRInto(const uint8_t* data, size_t data_size,
                           uint8_t* output_buffer, int output_buffer_size, int output_stride);

এই ফাংশনগুলি উপরেরগুলির রূপগুলি এবং চিত্রটিকে সরাসরি একটি পূর্ব-বরাদ্দ বাফার output_buffer এ ডিকোড করে। এই বাফারে উপলব্ধ সর্বাধিক স্টোরেজ output_buffer_size দ্বারা নির্দেশিত হয়। এই সঞ্চয়স্থান যথেষ্ট না হলে (বা একটি ত্রুটি ঘটেছে), NULL ফেরত দেওয়া হয়। অন্যথায়, সুবিধার জন্য output_buffer ফেরত দেওয়া হয়।

প্যারামিটার output_stride স্ক্যানলাইনগুলির মধ্যে দূরত্ব (বাইটে) নির্দিষ্ট করে। তাই, output_buffer_size কমপক্ষে output_stride * picture - height হবে বলে আশা করা হচ্ছে।

ইনপুট বৈশিষ্ট্য

তথ্য
WebP ইমেজ ডেটা পয়েন্টার
ডেটা_সাইজ
এটি ইমেজ ডেটা ধারণকারী data দ্বারা নির্দেশিত মেমরি ব্লকের আকার
আউটপুট_বাফার_সাইজ
পূর্ণসংখ্যার মান। বরাদ্দকৃত বাফারের আকার
output_stride
পূর্ণসংখ্যার মান। স্ক্যানলাইনের মধ্যে দূরত্ব নির্দিষ্ট করে।

রিটার্নস

আউটপুট_বাফার
ডিকোড করা WebP চিত্রে পয়েন্টার।
uint8_t*
output_buffer যদি ফাংশন সফল হয়; অন্যথায় NULL .

উন্নত ডিকোডিং API

ওয়েবপি ডিকোডিং একটি উন্নত API সমর্থন করে যাতে মোবাইল ফোনের মতো মেমরি-সীমাবদ্ধ পরিবেশে ফ্লাই ক্রপিং এবং রিস্কেল করার ক্ষমতা প্রদান করে। মূলত, মেমরির ব্যবহার আউটপুটের আকারের সাথে স্কেল হবে, ইনপুটের নয় যখন একজনের শুধুমাত্র দ্রুত প্রিভিউ প্রয়োজন বা অন্যথায় খুব বড় ছবির অংশে জুম করা দরকার। ঘটনাক্রমে কিছু CPUও সংরক্ষণ করা যেতে পারে।

WebP ডিকোডিং দুটি ভেরিয়েন্টে আসে যেমন ফুল ইমেজ ডিকোডিং এবং ছোট ইনপুট বাফারের উপর ইনক্রিমেন্টাল ডিকোডিং। ব্যবহারকারীরা ঐচ্ছিকভাবে ইমেজ ডিকোড করার জন্য একটি বাহ্যিক মেমরি বাফার প্রদান করতে পারেন। নিম্নলিখিত কোড নমুনা উন্নত ডিকোডিং API ব্যবহার করার ধাপের মধ্য দিয়ে যাবে।

প্রথমে আমাদের একটি কনফিগারেশন অবজেক্ট শুরু করতে হবে:

#include "webp/decode.h"

WebPDecoderConfig config;
CHECK(WebPInitDecoderConfig(&config));

// One can adjust some additional decoding options:
config.options.no_fancy_upsampling = 1;
config.options.use_scaling = 1;
config.options.scaled_width = scaledWidth();
config.options.scaled_height = scaledHeight();
// etc.

ডিকোড বিকল্পগুলি WebPDecoderConfig কাঠামোর মধ্যে একত্রিত হয়:

struct WebPDecoderOptions {
  int bypass_filtering;             // if true, skip the in-loop filtering
  int no_fancy_upsampling;          // if true, use faster pointwise upsampler
  int use_cropping;                 // if true, cropping is applied first 
  int crop_left, crop_top;          // top-left position for cropping.
                                    // Will be snapped to even values.
  int crop_width, crop_height;      // dimension of the cropping area
  int use_scaling;                  // if true, scaling is applied afterward
  int scaled_width, scaled_height;  // final resolution
  int use_threads;                  // if true, use multi-threaded decoding
  int dithering_strength;           // dithering strength (0=Off, 100=full)
  int flip;                         // if true, flip output vertically
  int alpha_dithering_strength;     // alpha dithering strength in [0..100]
};

ঐচ্ছিকভাবে বিটস্ট্রিম বৈশিষ্ট্যগুলি config.input এ পড়া যেতে পারে, যদি আমাদের আগে থেকে জানতে হয়। উদাহরণস্বরূপ, ছবিটির কিছু স্বচ্ছতা আছে কিনা তা জানা সহজ। মনে রাখবেন যে এটি বিটস্ট্রিমের শিরোনামকেও পার্স করবে, এবং তাই বিটস্ট্রিমটি একটি বৈধ WebP এর মত দেখাচ্ছে কিনা তা জানার একটি ভাল উপায়।

CHECK(WebPGetFeatures(data, data_size, &config.input) == VP8_STATUS_OK);

তারপরে আমাদের ডিকোডিং মেমরি বাফার সেটআপ করতে হবে যদি আমরা এটির বরাদ্দের জন্য ডিকোডারের উপর নির্ভর না করে সরাসরি সরবরাহ করতে চাই। আমাদের শুধুমাত্র মেমরিতে পয়েন্টার সরবরাহ করতে হবে সেইসাথে বাফারের মোট আকার এবং লাইন স্ট্রাইড (স্ক্যানলাইনের মধ্যে বাইটে দূরত্ব)।

// Specify the desired output colorspace:
config.output.colorspace = MODE_BGRA;
// Have config.output point to an external buffer:
config.output.u.RGBA.rgba = (uint8_t*)memory_buffer;
config.output.u.RGBA.stride = scanline_stride;
config.output.u.RGBA.size = total_size_of_the_memory_buffer;
config.output.is_external_memory = 1;

ছবিটি ডিকোড করার জন্য প্রস্তুত। ইমেজ ডিকোডিং জন্য দুটি সম্ভাব্য বৈকল্পিক আছে. আমরা ব্যবহার করে একবারে ইমেজ ডিকোড করতে পারি:

CHECK(WebPDecode(data, data_size, &config) == VP8_STATUS_OK);

পর্যায়ক্রমে, নতুন বাইট উপলব্ধ হওয়ার সাথে সাথে আমরা ক্রমান্বয়ে ইমেজটি ডিকোড করতে ক্রমবর্ধমান পদ্ধতি ব্যবহার করতে পারি:

WebPIDecoder* idec = WebPINewDecoder(&config.output);
CHECK(idec != NULL);
while (additional_data_is_available) {
  // ... (get additional data in some new_data[] buffer)
  VP8StatusCode status = WebPIAppend(idec, new_data, new_data_size);
  if (status != VP8_STATUS_OK && status != VP8_STATUS_SUSPENDED) {
    break;
  }
  // The above call decodes the current available buffer.
  // Part of the image can now be refreshed by calling
  // WebPIDecGetRGB()/WebPIDecGetYUVA() etc.
}
WebPIDelete(idec);  // the object doesn't own the image memory, so it can
                    // now be deleted. config.output memory is preserved.

ডিকোড করা চিত্রটি এখন config.output-এ রয়েছে (অথবা, এই ক্ষেত্রে config.output.u.RGBA-তে, যেহেতু অনুরোধ করা আউটপুট রঙের স্থানটি MODE_BGRA ছিল)। ছবি সংরক্ষণ, প্রদর্শন বা অন্যথায় প্রক্রিয়া করা যেতে পারে. পরবর্তীতে, আমাদের শুধুমাত্র কনফিগার অবজেক্টে বরাদ্দ করা মেমরি পুনরুদ্ধার করতে হবে। মেমরিটি বাহ্যিক হলেও এবং WebPDecode() দ্বারা বরাদ্দ না করা হলেও এই ফাংশনটিকে কল করা নিরাপদ:

WebPFreeDecBuffer(&config.output);

এই API ব্যবহার করে চিত্রটিকে YUV এবং YUVA ফর্ম্যাটে যথাক্রমে MODE_YUV এবং MODE_YUVA ব্যবহার করে ডিকোড করা যেতে পারে। এই বিন্যাসটিকে Y'CbCr ও বলা হয়।

সহজ এনকোডিং API

সবচেয়ে সাধারণ বিন্যাসে আরজিবিএ নমুনাগুলির এনকোডিং অ্যারেগুলির জন্য কিছু খুব সাধারণ ফাংশন সরবরাহ করা হয়। তারা webp/encode.h শিরোনামে ঘোষণা করা হয়েছে:

size_t WebPEncodeRGB(const uint8_t* rgb, int width, int height, int stride, float quality_factor, uint8_t** output);
size_t WebPEncodeBGR(const uint8_t* bgr, int width, int height, int stride, float quality_factor, uint8_t** output);
size_t WebPEncodeRGBA(const uint8_t* rgba, int width, int height, int stride, float quality_factor, uint8_t** output);
size_t WebPEncodeBGRA(const uint8_t* bgra, int width, int height, int stride, float quality_factor, uint8_t** output);

গুণমান ফ্যাক্টর quality_factor রেঞ্জ 0 থেকে 100 এবং কম্প্রেশনের সময় ক্ষতি এবং গুণমান নিয়ন্ত্রণ করে। মান 0 নিম্নমানের এবং ছোট আউটপুট আকারের সাথে মিলে যায়, যেখানে 100 হল সর্বোচ্চ মানের এবং বৃহত্তম আউটপুট আকার। সাফল্যের পরে, সংকুচিত বাইটগুলি *output পয়েন্টারে স্থাপন করা হয় এবং বাইটের আকার ফেরত দেওয়া হয় (অন্যথায় ব্যর্থতার ক্ষেত্রে 0 ফেরত দেওয়া হয়)। মেমরি পুনরুদ্ধার করতে কলকারীকে অবশ্যই *output পয়েন্টারে WebPFree() কল করতে হবে।

ইনপুট অ্যারেটি বাইটের একটি প্যাকড অ্যারে হওয়া উচিত (প্রতিটি চ্যানেলের জন্য একটি, ফাংশনের নামের দ্বারা প্রত্যাশিত)। stride এক সারি থেকে পরের সারিতে লাফানোর জন্য প্রয়োজনীয় বাইটের সংখ্যার সাথে মিলে যায়। উদাহরণস্বরূপ, বিজিআরএ লেআউট হল:

স্বাক্ষর সহ ক্ষতিহীন এনকোডিংয়ের জন্য সমতুল্য ফাংশন রয়েছে:

size_t WebPEncodeLosslessRGB(const uint8_t* rgb, int width, int height, int stride, uint8_t** output);
size_t WebPEncodeLosslessBGR(const uint8_t* bgr, int width, int height, int stride, uint8_t** output);
size_t WebPEncodeLosslessRGBA(const uint8_t* rgba, int width, int height, int stride, uint8_t** output);
size_t WebPEncodeLosslessBGRA(const uint8_t* bgra, int width, int height, int stride, uint8_t** output);

এই ফাংশনগুলি নোট করুন, ক্ষতিকারক সংস্করণগুলির মতো, লাইব্রেরির ডিফল্ট সেটিংস ব্যবহার করুন। ক্ষতিহীনের জন্য এর মানে 'সঠিক' নিষ্ক্রিয়। কম্প্রেশন উন্নত করতে স্বচ্ছ এলাকায় RGB মান পরিবর্তন করা হবে। এটি এড়াতে, WebPEncode() ব্যবহার করুন এবং WebPConfig::exact 1 এ সেট করুন।

উন্নত এনকোডিং API

হুডের নিচে, এনকোডারটি অনেক উন্নত এনকোডিং পরামিতি সহ আসে। কম্প্রেশন দক্ষতা এবং প্রক্রিয়াকরণ সময়ের মধ্যে ট্রেড-অফকে আরও ভালভাবে ভারসাম্য রাখতে তারা কার্যকর হতে পারে। এই প্যারামিটারগুলি WebPConfig কাঠামোর মধ্যে একত্রিত হয়। এই কাঠামোর সর্বাধিক ব্যবহৃত ক্ষেত্রগুলি হল:

struct WebPConfig {
  int lossless;           // Lossless encoding (0=lossy(default), 1=lossless).
  float quality;          // between 0 and 100. For lossy, 0 gives the smallest
                          // size and 100 the largest. For lossless, this
                          // parameter is the amount of effort put into the
                          // compression: 0 is the fastest but gives larger
                          // files compared to the slowest, but best, 100.
  int method;             // quality/speed trade-off (0=fast, 6=slower-better)

  WebPImageHint image_hint;  // Hint for image type (lossless only for now).

  // Parameters related to lossy compression only:
  int target_size;        // if non-zero, set the desired target size in bytes.
                          // Takes precedence over the 'compression' parameter.
  float target_PSNR;      // if non-zero, specifies the minimal distortion to
                          // try to achieve. Takes precedence over target_size.
  int segments;           // maximum number of segments to use, in [1..4]
  int sns_strength;       // Spatial Noise Shaping. 0=off, 100=maximum.
  int filter_strength;    // range: [0 = off .. 100 = strongest]
  int filter_sharpness;   // range: [0 = off .. 7 = least sharp]
  int filter_type;        // filtering type: 0 = simple, 1 = strong (only used
                          // if filter_strength > 0 or autofilter > 0)
  int autofilter;         // Auto adjust filter's strength [0 = off, 1 = on]
  int alpha_compression;  // Algorithm for encoding the alpha plane (0 = none,
                          // 1 = compressed with WebP lossless). Default is 1.
  int alpha_filtering;    // Predictive filtering method for alpha plane.
                          //  0: none, 1: fast, 2: best. Default if 1.
  int alpha_quality;      // Between 0 (smallest size) and 100 (lossless).
                          // Default is 100.
  int pass;               // number of entropy-analysis passes (in [1..10]).

  int show_compressed;    // if true, export the compressed picture back.
                          // In-loop filtering is not applied.
  int preprocessing;      // preprocessing filter (0=none, 1=segment-smooth)
  int partitions;         // log2(number of token partitions) in [0..3]
                          // Default is set to 0 for easier progressive decoding.
  int partition_limit;    // quality degradation allowed to fit the 512k limit on
                          // prediction modes coding (0: no degradation,
                          // 100: maximum possible degradation).
  int use_sharp_yuv;      // if needed, use sharp (and slow) RGB->YUV conversion
};

মনে রাখবেন যে এই প্যারামিটারগুলির বেশিরভাগই cwebp কমান্ড লাইন টুল ব্যবহার করে পরীক্ষার জন্য অ্যাক্সেসযোগ্য।

ইনপুট নমুনা একটি WebPPicture গঠনে আবৃত করা উচিত. use_argb পতাকার মানের উপর নির্ভর করে এই কাঠামোটি RGBA বা YUVA ফর্ম্যাটে ইনপুট নমুনা সংরক্ষণ করতে পারে।

কাঠামোটি নিম্নরূপ সংগঠিত হয়:

struct WebPPicture {
  int use_argb;              // To select between ARGB and YUVA input.

  // YUV input, recommended for lossy compression.
  // Used if use_argb = 0.
  WebPEncCSP colorspace;     // colorspace: should be YUVA420 or YUV420 for now (=Y'CbCr).
  int width, height;         // dimensions (less or equal to WEBP_MAX_DIMENSION)
  uint8_t *y, *u, *v;        // pointers to luma/chroma planes.
  int y_stride, uv_stride;   // luma/chroma strides.
  uint8_t* a;                // pointer to the alpha plane
  int a_stride;              // stride of the alpha plane

  // Alternate ARGB input, recommended for lossless compression.
  // Used if use_argb = 1.
  uint32_t* argb;            // Pointer to argb (32 bit) plane.
  int argb_stride;           // This is stride in pixels units, not bytes.

  // Byte-emission hook, to store compressed bytes as they are ready.
  WebPWriterFunction writer;  // can be NULL
  void* custom_ptr;           // can be used by the writer.

  // Error code for the latest error encountered during encoding
  WebPEncodingError error_code;
};

এই কাঠামোতে সংকুচিত বাইটগুলিকে উপলব্ধ করার সাথে সাথে নির্গত করার একটি ফাংশন রয়েছে। একটি ইন-মেমরি লেখকের সাথে একটি উদাহরণের জন্য নীচে দেখুন। অন্যান্য লেখকরা সরাসরি একটি ফাইলে ডেটা সঞ্চয় করতে পারেন (এ ধরনের উদাহরণের জন্য examples/cwebp.c দেখুন)।

উন্নত API ব্যবহার করে এনকোডিংয়ের জন্য সাধারণ প্রবাহটি নিম্নলিখিতটির মতো দেখায়:

প্রথমত, আমাদের কম্প্রেশন প্যারামিটার সহ একটি এনকোডিং কনফিগারেশন সেট আপ করতে হবে। মনে রাখবেন যে একই কনফিগারেশন পরে বিভিন্ন ইমেজ সংকুচিত করার জন্য ব্যবহার করা যেতে পারে।

#include "webp/encode.h"

WebPConfig config;
if (!WebPConfigPreset(&config, WEBP_PRESET_PHOTO, quality_factor)) return 0;   // version error

// Add additional tuning:
config.sns_strength = 90;
config.filter_sharpness = 6;
config.alpha_quality = 90;
config_error = WebPValidateConfig(&config);  // will verify parameter ranges (always a good habit)

তারপর, ইনপুট নমুনাগুলিকে রেফারেন্স বা অনুলিপি দ্বারা একটি WebPPicture এ উল্লেখ করতে হবে। এখানে নমুনা রাখার জন্য বাফার বরাদ্দ করার একটি উদাহরণ রয়েছে। কিন্তু কেউ সহজেই একটি ইতিমধ্যে-বরাদ্দ নমুনা অ্যারেতে একটি "ভিউ" সেট আপ করতে পারে। WebPPictureView() ফাংশন দেখুন।

// Setup the input data, allocating a picture of width x height dimension
WebPPicture pic;
if (!WebPPictureInit(&pic)) return 0;  // version error
pic.width = width;
pic.height = height;
if (!WebPPictureAlloc(&pic)) return 0;   // memory error

// At this point, 'pic' has been initialized as a container, and can receive the YUVA or RGBA samples.
// Alternatively, one could use ready-made import functions like WebPPictureImportRGBA(), which will take
// care of memory allocation. In any case, past this point, one will have to call WebPPictureFree(&pic)
// to reclaim allocated memory.

সংকুচিত বাইট নির্গত করার জন্য, প্রতিবার নতুন বাইট উপলব্ধ হলে একটি হুক বলা হয়। এখানে webp/encode.h এ ঘোষিত মেমরি-রাইটারের সাথে একটি সহজ উদাহরণ দেওয়া হল। প্রতিটি ছবি সংকুচিত করার জন্য এই প্রাথমিককরণের প্রয়োজন হতে পারে:

// Set up a byte-writing method (write-to-memory, in this case):
WebPMemoryWriter writer;
WebPMemoryWriterInit(&writer);
pic.writer = WebPMemoryWrite;
pic.custom_ptr = &writer;

আমরা এখন ইনপুট নমুনাগুলি সংকুচিত করতে প্রস্তুত (এবং পরে তাদের স্মৃতি মুক্ত):

int ok = WebPEncode(&config, &pic);
WebPPictureFree(&pic);   // Always free the memory associated with the input.
if (!ok) {
  printf("Encoding error: %d\n", pic.error_code);
} else {
  printf("Output size: %d\n", writer.size);
}

API এবং কাঠামোর আরও উন্নত ব্যবহারের জন্য, webp/encode.h শিরোনামে উপলব্ধ ডকুমেন্টেশনগুলি দেখার পরামর্শ দেওয়া হচ্ছে৷ উদাহরণ কোড examples/cwebp.c পড়া কম ব্যবহৃত পরামিতি আবিষ্কারের জন্য দরকারী প্রমাণিত হতে পারে।