Add GDALNearblack binding

errors.go

@@ -151,6 +151,7 @@ func ErrLogger(fn ErrorHandler) interface {
 	SetStatisticsOption
 	ClearStatisticsOption
 	GridOption
+	NearblackOption
 } {
 	return errorCallback{fn}
 }
@@ -368,6 +369,9 @@ func (ec errorCallback) setGridCreateOpt(o *gridCreateOpts) {
 func (ec errorCallback) setGridOpt(o *gridOpts) {
 	o.errorHandler = ec.fn
 }
+func (ec errorCallback) setNearblackOpt(o *nearBlackOpts) {
+	o.errorHandler = ec.fn
+}
 
 type multiError struct {
 	errs []error

godal.cpp

@@ -1744,6 +1744,27 @@ GDALDatasetH godalGrid(cctx *ctx, const char *pszDest, GDALDatasetH hSrcDS, char
 		forceError(ctx);
 	}
 
+	godalUnwrap();
+	return ret;
+}
+
+GDALDatasetH godalNearblack(cctx *ctx, const char *pszDest, GDALDatasetH hDstDS, GDALDatasetH hSrcDS, char **switches) {
+	godalWrap(ctx);
+
+	GDALNearblackOptions *nbopts = GDALNearblackOptionsNew(switches,nullptr);
+	if(failed(ctx)) {
+		GDALNearblackOptionsFree(nbopts);
+		godalUnwrap();
+		return nullptr;
+	}
+
+	int usageErr=0;
+	GDALDatasetH ret = GDALNearblack(pszDest, hDstDS, hSrcDS, nbopts, &usageErr);
+	GDALNearblackOptionsFree(nbopts);
+	if(ret==nullptr || usageErr!=0) {
+		forceError(ctx);
+	}
+
 	godalUnwrap();
 	return ret;
 }

godal.go

@@ -210,7 +210,7 @@ func (band Band) ClearNoData(opts ...SetNoDataOption) error {
 	return cgc.close()
 }
 
-//SetScaleOffset sets the band's scale and offset
+// SetScaleOffset sets the band's scale and offset
 func (band Band) SetScaleOffset(scale, offset float64, opts ...SetScaleOffsetOption) error {
 	setterOpts := &setScaleOffsetOpts{}
 	for _, opt := range opts {
@@ -891,7 +891,7 @@ func (ds *Dataset) SetNoData(nd float64, opts ...SetNoDataOption) error {
 	return cgc.close()
 }
 
-//SetScale sets the band's scale and offset
+// SetScaleOffset sets the band's scale and offset
 func (ds *Dataset) SetScaleOffset(scale, offset float64, opts ...SetScaleOffsetOption) error {
 	setterOpts := &setScaleOffsetOpts{}
 	for _, opt := range opts {
@@ -3849,6 +3849,69 @@ func (ds *Dataset) Grid(destPath string, switches []string, opts ...GridOption)
 	return &Dataset{majorObject{C.GDALMajorObjectH(dsRet)}}, nil
 }
 
+// `Nearblack` and `NearblackInto` run the library version of GDALNearblack. The difference between them is:
+//   - Nearblack: Takes a `destPath` (string) as its first arg, the produced dataset will be output to this "file"
+//     and returned from the function
+//   - NearblackInto: Instead takes a `srcDs` (Dataset) as its first arg, the produced dataset will be stored in
+//     the `Dataset` this method was called from
+//
+// See the nearblack doc page to determine the valid flags/opts that can be set in switches.
+//
+// Example switches :
+//
+//	[]string{"-white", "-near", "10"}
+//
+// Creation options and driver may be set in the switches slice with
+//
+//	switches:=[]string{"-co","TILED=YES","-of","GTiff"}
+//
+// NOTE: Some switches are NOT compatible with this binding, as a `nullptr` is passed to a later call to
+// `GDALNearblackOptionsNew()` (as the 2nd argument). Those switches are: "-o", "-q", "-quiet"
+func (ds *Dataset) Nearblack(destPath string, switches []string, opts ...NearblackOption) (*Dataset, error) {
+	nearBlackOpts := nearBlackOpts{}
+	for _, opt := range opts {
+		opt.setNearblackOpt(&nearBlackOpts)
+	}
+
+	cswitches := sliceToCStringArray(switches)
+	defer cswitches.free()
+
+	dest := unsafe.Pointer(C.CString(destPath))
+	defer C.free(dest)
+
+	cgc := createCGOContext(nil, nearBlackOpts.errorHandler)
+
+	ret, err := C.godalNearblack(cgc.cPointer(), (*C.char)(dest), nil, ds.handle(), cswitches.cPointer())
+	if err = cgc.close(); err != nil {
+		return nil, err
+	}
+
+	return &Dataset{majorObject{C.GDALMajorObjectH(ret)}}, nil
+}
+
+func (ds *Dataset) NearblackInto(srcDs *Dataset, switches []string, opts ...NearblackOption) error {
+	nearBlackOpts := nearBlackOpts{}
+	for _, opt := range opts {
+		opt.setNearblackOpt(&nearBlackOpts)
+	}
+
+	cswitches := sliceToCStringArray(switches)
+	defer cswitches.free()
+
+	cgc := createCGOContext(nil, nearBlackOpts.errorHandler)
+
+	var srcDsHandle C.GDALDatasetH = nil
+	if srcDs != nil {
+		srcDsHandle = srcDs.handle()
+	}
+	_ = C.godalNearblack(cgc.cPointer(), nil, ds.handle(), srcDsHandle, cswitches.cPointer())
+	if err := cgc.close(); err != nil {
+		return err
+	}
+
+	return nil
+}
+
 type cgoContext struct {
 	cctx *C.cctx
 	opts cStringArray

godal.h

@@ -153,6 +153,7 @@ extern "C" {
     void godalSetRasterStatistics(cctx *ctx, GDALRasterBandH bnd, double dfMin, double dfMax, double dfMean, double dfStdDev);
 	void godalGridCreate(cctx *ctx, char *pszAlgorithm, GDALGridAlgorithm eAlgorithm, GUInt32 nPoints, const double *padfX, const double *padfY, const double *padfZ, double dfXMin, double dfXMax, double dfYMin, double dfYMax, GUInt32 nXSize, GUInt32 nYSize, GDALDataType eType, void *pData);
 	GDALDatasetH godalGrid(cctx *ctx, const char *pszDest, GDALDatasetH hSrcDS, char **switches);
+	GDALDatasetH godalNearblack(cctx *ctx, const char *pszDest, GDALDatasetH hDstDS, GDALDatasetH hSrcDS, char **switches);
 #ifdef __cplusplus
 }
 #endif