@girs/gdkpixbuf-2.0 2.0.0-3.0.0 → 2.0.0-3.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,7 +1,11 @@
1
1
 
2
2
  # GdkPixbuf-2.0
3
3
 
4
- GJS TypeScript type definitions for GdkPixbuf-2.0, generated from library version 2.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.0.0.
4
+ ![version](https://img.shields.io/npm/v/@girs/gdkpixbuf-2.0)
5
+ ![downloads/week](https://img.shields.io/npm/dw/@girs/gdkpixbuf-2.0)
6
+
7
+
8
+ GJS TypeScript type definitions for GdkPixbuf-2.0, generated from library version 2.0.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.0.3.
5
9
 
6
10
  GdkPixbuf is a library for image loading and manipulation. The GdkPixbuf documentation contains both the programmer's guide and the API reference.
7
11
 
@@ -238,6 +238,47 @@ export interface PixbufModuleFillInfoFunc {
238
238
  export interface PixbufModuleFillVtableFunc {
239
239
  (module: PixbufModule): void
240
240
  }
241
+ /**
242
+ * Incrementally loads a buffer into the image data.
243
+ * @callback
244
+ * @param context the state object created by [callback`GdkPixbuf`.PixbufModuleBeginLoadFunc]
245
+ * @param buf the data to load
246
+ * @returns `TRUE` if the incremental load was successful
247
+ */
248
+ export interface PixbufModuleIncrementLoadFunc {
249
+ (context: any | null, buf: Uint8Array): boolean
250
+ }
251
+ /**
252
+ * Loads a file from a standard C file stream into a new `GdkPixbufAnimation`.
253
+ *
254
+ * In case of error, this function should return `NULL` and set the `error` argument.
255
+ * @callback
256
+ * @param f the file stream from which the image should be loaded
257
+ * @returns a newly created `GdkPixbufAnimation` for the contents of the file
258
+ */
259
+ export interface PixbufModuleLoadAnimationFunc {
260
+ (f: any | null): PixbufAnimation
261
+ }
262
+ /**
263
+ * Loads a file from a standard C file stream into a new `GdkPixbuf`.
264
+ *
265
+ * In case of error, this function should return `NULL` and set the `error` argument.
266
+ * @callback
267
+ * @param f the file stream from which the image should be loaded
268
+ * @returns a newly created `GdkPixbuf` for the contents of the file
269
+ */
270
+ export interface PixbufModuleLoadFunc {
271
+ (f: any | null): Pixbuf
272
+ }
273
+ /**
274
+ * Loads XPM data into a new `GdkPixbuf`.
275
+ * @callback
276
+ * @param data the XPM data
277
+ * @returns a newly created `GdkPixbuf` for the XPM data
278
+ */
279
+ export interface PixbufModuleLoadXpmDataFunc {
280
+ (data: string[]): Pixbuf
281
+ }
241
282
  /**
242
283
  * Defines the type of the function that gets called once the initial
243
284
  * setup of `pixbuf` is done.
@@ -252,6 +293,31 @@ export interface PixbufModuleFillVtableFunc {
252
293
  export interface PixbufModulePreparedFunc {
253
294
  (pixbuf: Pixbuf, anim: PixbufAnimation): void
254
295
  }
296
+ /**
297
+ * Saves a `GdkPixbuf` into a standard C file stream.
298
+ *
299
+ * The optional `param_keys` and `param_values` arrays contain the keys and
300
+ * values (in the same order) for attributes to be saved alongside the image
301
+ * data.
302
+ * @callback
303
+ * @param f the file stream into which the image should be saved
304
+ * @param pixbuf the image to save
305
+ * @param param_keys parameter keys to save
306
+ * @param param_values parameter values to save
307
+ * @returns `TRUE` on success; in case of failure, `FALSE` is returned and the `error` is set
308
+ */
309
+ export interface PixbufModuleSaveFunc {
310
+ (f: any | null, pixbuf: Pixbuf, param_keys: string[] | null, param_values: string[] | null): boolean
311
+ }
312
+ /**
313
+ * Checks whether the given `option_key` is supported when saving.
314
+ * @callback
315
+ * @param option_key the option key to check
316
+ * @returns `TRUE` if the option is supported
317
+ */
318
+ export interface PixbufModuleSaveOptionSupportedFunc {
319
+ (option_key: string | null): boolean
320
+ }
255
321
  /**
256
322
  * Defines the type of the function that gets called once the size
257
323
  * of the loaded image is known.
@@ -273,6 +339,17 @@ export interface PixbufModulePreparedFunc {
273
339
  export interface PixbufModuleSizeFunc {
274
340
  (width: number, height: number): void
275
341
  }
342
+ /**
343
+ * Finalizes the image loading state.
344
+ *
345
+ * This function is called on success and error states.
346
+ * @callback
347
+ * @param context the state object created by [callback`GdkPixbuf`.PixbufModuleBeginLoadFunc]
348
+ * @returns `TRUE` if the loading operation was successful
349
+ */
350
+ export interface PixbufModuleStopLoadFunc {
351
+ (context: any | null): boolean
352
+ }
276
353
  /**
277
354
  * Defines the type of the function that gets called every time a region
278
355
  * of `pixbuf` is updated.
@@ -2564,10 +2641,41 @@ export interface PixbufModule {
2564
2641
  * @field
2565
2642
  */
2566
2643
  info: PixbufFormat
2567
- stop_load: (context: any) => boolean
2568
- load_increment: (context: any, buf: number, size: number) => boolean
2569
- save: (f: any, pixbuf: Pixbuf, param_keys: string | null, param_values: string | null) => boolean
2570
- is_save_option_supported: (option_key: string | null) => boolean
2644
+ /**
2645
+ * loads an image from a file.
2646
+ * @field
2647
+ */
2648
+ load: PixbufModuleLoadFunc
2649
+ /**
2650
+ * loads an image from data in memory.
2651
+ * @field
2652
+ */
2653
+ load_xpm_data: PixbufModuleLoadXpmDataFunc
2654
+ /**
2655
+ * stops an incremental load.
2656
+ * @field
2657
+ */
2658
+ stop_load: PixbufModuleStopLoadFunc
2659
+ /**
2660
+ * continues an incremental load.
2661
+ * @field
2662
+ */
2663
+ load_increment: PixbufModuleIncrementLoadFunc
2664
+ /**
2665
+ * loads an animation from a file.
2666
+ * @field
2667
+ */
2668
+ load_animation: PixbufModuleLoadAnimationFunc
2669
+ /**
2670
+ * saves a `GdkPixbuf` to a file.
2671
+ * @field
2672
+ */
2673
+ save: PixbufModuleSaveFunc
2674
+ /**
2675
+ * returns whether a save option key is supported by the module
2676
+ * @field
2677
+ */
2678
+ is_save_option_supported: PixbufModuleSaveOptionSupportedFunc
2571
2679
  }
2572
2680
 
2573
2681
  /**
@@ -240,6 +240,47 @@ interface PixbufModuleFillInfoFunc {
240
240
  interface PixbufModuleFillVtableFunc {
241
241
  (module: PixbufModule): void
242
242
  }
243
+ /**
244
+ * Incrementally loads a buffer into the image data.
245
+ * @callback
246
+ * @param context the state object created by [callback`GdkPixbuf`.PixbufModuleBeginLoadFunc]
247
+ * @param buf the data to load
248
+ * @returns `TRUE` if the incremental load was successful
249
+ */
250
+ interface PixbufModuleIncrementLoadFunc {
251
+ (context: any | null, buf: Uint8Array): boolean
252
+ }
253
+ /**
254
+ * Loads a file from a standard C file stream into a new `GdkPixbufAnimation`.
255
+ *
256
+ * In case of error, this function should return `NULL` and set the `error` argument.
257
+ * @callback
258
+ * @param f the file stream from which the image should be loaded
259
+ * @returns a newly created `GdkPixbufAnimation` for the contents of the file
260
+ */
261
+ interface PixbufModuleLoadAnimationFunc {
262
+ (f: any | null): PixbufAnimation
263
+ }
264
+ /**
265
+ * Loads a file from a standard C file stream into a new `GdkPixbuf`.
266
+ *
267
+ * In case of error, this function should return `NULL` and set the `error` argument.
268
+ * @callback
269
+ * @param f the file stream from which the image should be loaded
270
+ * @returns a newly created `GdkPixbuf` for the contents of the file
271
+ */
272
+ interface PixbufModuleLoadFunc {
273
+ (f: any | null): Pixbuf
274
+ }
275
+ /**
276
+ * Loads XPM data into a new `GdkPixbuf`.
277
+ * @callback
278
+ * @param data the XPM data
279
+ * @returns a newly created `GdkPixbuf` for the XPM data
280
+ */
281
+ interface PixbufModuleLoadXpmDataFunc {
282
+ (data: string[]): Pixbuf
283
+ }
243
284
  /**
244
285
  * Defines the type of the function that gets called once the initial
245
286
  * setup of `pixbuf` is done.
@@ -254,6 +295,31 @@ interface PixbufModuleFillVtableFunc {
254
295
  interface PixbufModulePreparedFunc {
255
296
  (pixbuf: Pixbuf, anim: PixbufAnimation): void
256
297
  }
298
+ /**
299
+ * Saves a `GdkPixbuf` into a standard C file stream.
300
+ *
301
+ * The optional `param_keys` and `param_values` arrays contain the keys and
302
+ * values (in the same order) for attributes to be saved alongside the image
303
+ * data.
304
+ * @callback
305
+ * @param f the file stream into which the image should be saved
306
+ * @param pixbuf the image to save
307
+ * @param param_keys parameter keys to save
308
+ * @param param_values parameter values to save
309
+ * @returns `TRUE` on success; in case of failure, `FALSE` is returned and the `error` is set
310
+ */
311
+ interface PixbufModuleSaveFunc {
312
+ (f: any | null, pixbuf: Pixbuf, param_keys: string[] | null, param_values: string[] | null): boolean
313
+ }
314
+ /**
315
+ * Checks whether the given `option_key` is supported when saving.
316
+ * @callback
317
+ * @param option_key the option key to check
318
+ * @returns `TRUE` if the option is supported
319
+ */
320
+ interface PixbufModuleSaveOptionSupportedFunc {
321
+ (option_key: string | null): boolean
322
+ }
257
323
  /**
258
324
  * Defines the type of the function that gets called once the size
259
325
  * of the loaded image is known.
@@ -275,6 +341,17 @@ interface PixbufModulePreparedFunc {
275
341
  interface PixbufModuleSizeFunc {
276
342
  (width: number, height: number): void
277
343
  }
344
+ /**
345
+ * Finalizes the image loading state.
346
+ *
347
+ * This function is called on success and error states.
348
+ * @callback
349
+ * @param context the state object created by [callback`GdkPixbuf`.PixbufModuleBeginLoadFunc]
350
+ * @returns `TRUE` if the loading operation was successful
351
+ */
352
+ interface PixbufModuleStopLoadFunc {
353
+ (context: any | null): boolean
354
+ }
278
355
  /**
279
356
  * Defines the type of the function that gets called every time a region
280
357
  * of `pixbuf` is updated.
@@ -2566,10 +2643,41 @@ interface PixbufModule {
2566
2643
  * @field
2567
2644
  */
2568
2645
  info: PixbufFormat
2569
- stop_load: (context: any) => boolean
2570
- load_increment: (context: any, buf: number, size: number) => boolean
2571
- save: (f: any, pixbuf: Pixbuf, param_keys: string | null, param_values: string | null) => boolean
2572
- is_save_option_supported: (option_key: string | null) => boolean
2646
+ /**
2647
+ * loads an image from a file.
2648
+ * @field
2649
+ */
2650
+ load: PixbufModuleLoadFunc
2651
+ /**
2652
+ * loads an image from data in memory.
2653
+ * @field
2654
+ */
2655
+ load_xpm_data: PixbufModuleLoadXpmDataFunc
2656
+ /**
2657
+ * stops an incremental load.
2658
+ * @field
2659
+ */
2660
+ stop_load: PixbufModuleStopLoadFunc
2661
+ /**
2662
+ * continues an incremental load.
2663
+ * @field
2664
+ */
2665
+ load_increment: PixbufModuleIncrementLoadFunc
2666
+ /**
2667
+ * loads an animation from a file.
2668
+ * @field
2669
+ */
2670
+ load_animation: PixbufModuleLoadAnimationFunc
2671
+ /**
2672
+ * saves a `GdkPixbuf` to a file.
2673
+ * @field
2674
+ */
2675
+ save: PixbufModuleSaveFunc
2676
+ /**
2677
+ * returns whether a save option key is supported by the module
2678
+ * @field
2679
+ */
2680
+ is_save_option_supported: PixbufModuleSaveOptionSupportedFunc
2573
2681
  }
2574
2682
 
2575
2683
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@girs/gdkpixbuf-2.0",
3
- "version": "2.0.0-3.0.0",
3
+ "version": "2.0.0-3.0.3",
4
4
  "description": "GJS TypeScript type definitions for GdkPixbuf-2.0, generated from library version 2.0.0",
5
5
  "type": "module",
6
6
  "module": "gdkpixbuf-2.0.js",
@@ -31,14 +31,14 @@
31
31
  "test:cjs": "tsc --noEmit gdkpixbuf-2.0.d.cts"
32
32
  },
33
33
  "dependencies": {
34
- "@girs/gjs": "^3.0.0",
35
- "@girs/gio-2.0": "^2.76.1-3.0.0",
36
- "@girs/gobject-2.0": "^2.76.1-3.0.0",
37
- "@girs/glib-2.0": "^2.76.1-3.0.0",
38
- "@girs/gmodule-2.0": "^2.0.0-3.0.0"
34
+ "@girs/gio-2.0": "^2.76.1-3.0.3",
35
+ "@girs/gjs": "^3.0.3",
36
+ "@girs/glib-2.0": "^2.76.1-3.0.3",
37
+ "@girs/gmodule-2.0": "^2.0.0-3.0.3",
38
+ "@girs/gobject-2.0": "^2.76.1-3.0.3"
39
39
  },
40
40
  "devDependencies": {
41
- "typescript": "^5.0.4"
41
+ "typescript": "*"
42
42
  },
43
43
  "keywords": [
44
44
  "Gir",