C++ ときどき ごはん、わりとてぃーぶれいく☆

USAGI.NETWORKのなかのひとのブログ。主にC++。

UE4: C++ コード から C++ クラスまたは Blueprint のアクターを FindObject して SpawnActor する方法

UE4 C++ Blueprint SpawnActor FActorSpawnParameters ConstructorHelpers::FObjectFinder tips

UE4/C++er も Blueprint クラスを C++ コードから使用する必要がある場合はまま生じます。C++で実装するよりも Blueprint で実装した方が都合の善いクラスを C++ で実装したクラスから扱いたい場合にどうするか、 SpawnActor する場合を例に、 C++ クラスを扱う場合と Blurprint クラスを扱う場合を並べて整理します。

0. 共通: FActorSpawnParameters を定義する

FActorSpawnParameters params;

// 必要に応じてパラメーターを設定する。
params.bAllowDuringConstructionScript = true;
params.bDeferConstruction = false;
params.bNoFail = true;
params.Instigator = this;
params.Name = { };
params.ObjectFlags = EObjectFlags::RF_NoFlags;
params.OverrideLevel = nullptr;
params.Owner = this;
params.SpawnCollisionHandlingOverride = ESpawnActorCollisionHandlingMethod::AlwaysSpawn;
params.Template = nullptr;

1. C++ クラスを SpawnActor （とても簡単）

// 事前に用意した params と必要な SpawnActor のオーバーロードを使う。
// ASomethingActor は必要に応じて #include "SomethingActor.h" など参照可能にしておく。
auto something =
  GetWorld()->SpawnActor< ASomethingActor >
  ( GetActorLocation()
  , GetActorRotation()
  , params
  );

2. Blueprint のアクターを SpawnActor （実装方法に少々癖がある）

仕込み

step.1 SpawnActor を行う C++ のアクタークラスの .h に SpawnActor される Blurprint クラスのオブジェクトを保持する仕込みを行う。

// StaticMeshActor を使いたい場合には必要
#include "Runtime/Engine/Classes/Engine/StaticMeshActor.h"

protected:
  // 例えば目的の Blurprint クラスが AStaticMeshActor ならそのオブジェクトの SpawnActor 用に参照させるオブジェクトの保持はこんな感じ。
  // （よりゆるくは AActor* でもよい。）
  TSubclassOf< class AStaticMeshActor > something_object = nullptr;

step.2 SpawnActor を行う C++ のアクタークラスの .cpp の ctor で SpawnActor される Blurprint クラスを ConstructorHelpers::FindObject で取得し、オブジェクトを保持しておく仕込みを行う。

// ConstructorHelpers::FObjectFinder に必要
#include "Runtime/CoreUObject/Public/UObject/ConstructorHelpers.h"

// ctor
MyGameCharacter::MyGameCharacter()
  // コンテントブラウザーで /Content 以下のパスが /Game 以下のパスに置き換わり、
  // コンテントブラウザーで名前が Something_Blueprint なら Something_Blueprint.Something_Blueprint_C が FindObject する名前になる。
  // UE4/C++er は C++ コードから Blurprint クラスを参照する際は . で繋がり終わりに _C が付くルールを覚えておく必要がある。
  static ConstructorHelpers::FObjectFinder< UClass > found_something_object( TEXT( "/Game/Something_Blueprint.Something_Blueprint_C" ) );
  something_object = found_something_object.Object;

SpawnActor

// 仕込みで用意しておいた something_object を使う SpawnActor のオーバーロードを使う。
auto something =
  GetWorld()->SpawnActor< AStaticMeshActor>
  ( something_object // <-- ここで UClass* なオブジェクトを渡すために事前の仕込みが必要
  , GetActorLocation()
  , GetActorRotation()
  , params
  );

参考

  1. SpawnActor | Unreal Engine API Reference
  2. FObjectFinder | Unreal Engine API Reference
  3. AStaticMeshActor | Unreal Engine API Reference
  4. Spawning Actors - Unreal Engine Forums

趣味のゲーム、作り始めました😃

WRS1 UE4 Metasequoia4

Microsoft の VSTS の SSH 接続時の URL が変更されたらしい

VSTS git ssh update url Microsoft

private で大きめなファイルも含むプロジェクトを扱う場合は GitHub や BitBucket よりも最近では VSTS が便利なので UE4 のプロジェクトなどに使っています。今日、 git push をコンソールでしたところ、次のメッセージを確認しました。

remote: *******************************************************************************
remote: *         After November 17th, 2017.                                          *
remote: *         Old SSH remote URLs will be retired and you will need to update     *
remote: *         your SSH Git remotes.                                               *
remote: *                                                                             *
remote: *         If you haven't already done this:                                   *
remote: *         - Visit your VSTS repository on the web.                            *
remote: *         - Press the Clone button on the top right corner.                   *
remote: *         - Press SSH and copy the new SSH remote URL.                        *
remote: *         - In your Git client, run the following:                            *
remote: *               git remote set-url {Your Remote Name} {Your New SSH URL}      *
remote: *                                                                             *
remote: *         For more information, refer to                                      *
remote: *               https://go.microsoft.com/fwlink/?linkid=855768                *
remote: *******************************************************************************

VSTS へ SSH 接続する場合の URL が変更されていたようです。2017年11月17日以降は旧い URL は使えなくなるから更新してねというお知らせ。

.git/config を変更して対応します。（gitコマンドで変更しても同じ）

# <project> と <repository> は適当に読み替えて下さい。
# old:
url = ssh://<project>@<project>.visualstudio.com:22/_git/<repository>
# new:
url = ssh://<project>@vs-ssh.visualstudio.com:22/_ssh/<repository>

わざわざメッセージを出して知らせてくれる、そのメッセージなら読むであろう CUI ユーザー層を十分に考慮してくれている親切さが嬉しいと感じました。今後も適材適所で VSTS を利用したいと思います。 VSTS は他の git ホスティングサービスに比べるとリポジトリー操作、応答性が速いのも嬉しいポイントです。

UE4のエンジンアップデートで調整済みのBPを消し飛ばしてしまった備忘録

UE4 update engine fault

UE4で開発中に編集するコンテントにはプロジェクトごとに管理されるユーザー定義のソースやブループリントやマテリアルの他に、エンジンのコンテントを参照するものが含まれる事があります。例えば、 BP_Sky_Sphere とか。

今回のやらかした記録はそのUE4のエンジンコンテントの BP_Sky_Shpere をプロジェクトでカスタマイズして使っている状況でエンジンのリビジョンアップをしてしまい、調整したBPが消し飛んでしまったというお話。

痛いうっかり。

だいじなこと：『エンジンのコンテントをカスタマイズする際は忘れずにプロジェクトへカスタマイズ元のブループリント等をコピーした上で行いましょう(´・ω・｀)』

ちなみに、「消し飛んだ」と言っても、プロジェクトでカスタマイズしている最中に自動保存が発生したタイミングごと、プロジェクトのディレクトリーの Saved/Backup/ にバックアップが残っているので、最終版ではないものの、今回はそこからサルベージした最終版に近い状態を元に作業を復旧させました。

ブループリントとしてはやや複雑なカスタマイズを施していたので、まっさらになっていたら再実装には数日掛かるところでした。(;´д｀)ﾄﾎﾎ…

だいじなこと：『エンジンのコンテントをカスタマイズする際は忘れずにプロジェクトへカスタマイズ元のブループリント等をコピーした上で行いましょう(´・ω・｀)』

自分の記憶用に2回書きました。

カメラで撮影した .MOV を Adobe Premiere で .mp4 にしても Instagram へ投降すると「動画をレンダリングできません」となる場合の対処方法

状況と経緯

小松空港と新千歳空港を往復する際に、 OLYMPUS OM-D E-M1 Mark II で離陸と着陸の動画を窓から撮影しました。そのままだと離陸も着陸も10分ほどの動画で眺めるにも少々長く、 Instagram へ投降するにも 60 秒に調整する必要があるため Adobe Premiere で .MOV のソースを繋げて全体を 60 秒に縮めて .mp4 出力し、 Android の Instagram から動画を投降しようとしました。

f:id:USAGI-WRP:20170930062100p:plain

投降できたかな？と思ったものの、タイムラインに「まだ投降されていません。もう一度実行してください。」と表示され、ぐるり矢印をぽちっとすると、上に挙げた「動画を投降できませんでした」「動画をレンダリングできません。この問題が繰り返し発生する場合は、別の動画を使用する必要があるかもしれません。」と。何度かぽちって見ましたが状況が繰り返すだけでした。

このような問題は Instagram の動画投降ではよくある事で、昔はエラー表示どころか Instagram が落ちる事がほとんどでしたのでその頃に比べるとユーザーフレンドリーになったような気はします。

原因と解決

今回 Instagram で動画を投降できなかった原因は 60 FPS の動画を扱わせようとした事でした。 Premiere のシーケンスを 29.97 FPS へ変更して出力しなおしたところ、 Instagram で投稿完了まで期待通りに扱えるようになりました。

一般論

Instagram が取り扱える動画には幾つかの制約があるようです。適当に調査した限りで一般に動画出力時に注意する必要のある事は次のような条件のようです（参考1; 但し公式情報ではなく最新版では変更される可能性もあります。注意。）:

  1. 動画全体の時間は 60 秒以下
  2. 動画のフレームレートは 30 FPS 以下
  3. ファイルサイズは 4 GB 以下
  4. 最大分解能は 1800x945 、1080x1080 、 864x1080
  5. 動画CODECは H.264 、 VP8
  6. 音声CODECは AAC 、 Vorbis

おまけ: Instagram へ今回投稿した動画

小松空港・離陸→新千歳空港・着陸

www.instagram.com

参考

  1. Instagram Video Formats & Export Settings for Premiere Pro — Premiere Gal

ダーク・エクセル

dark theme Excel Microsoft background

白い画面は眩しくて疲れます。 Microsoft Excel をダークなテーマで使いたいニーズはそれなりにあると思います。簡単な方法は無いだろうと諦めていたのですが、いつの間にか簡単にダーク・エクセルを実現できるようになっていたようです。

f:id:USAGI-WRP:20170921014103p:plain

この状態にする手順は3段階。

  1. File -> Option -> General -> Personalize your copy of Microsft Office -> Office Theme を Black へ。
  2. Page Layout -> Page Setup -> Background から適当な濃い灰色の1pxの画像ファイルを設定。（適用には若干の負荷がかかる）
  3. すべてセルを選択し、 Home -> Font -> Font Color を Gray に設定。（お好みで White でも何でも）

f:id:USAGI-WRP:20170921014316p:plain

f:id:USAGI-WRP:20170921014858p:plain

f:id:USAGI-WRP:20170921021729p:plain

おまけ: 1px の適当な濃い灰色画像

f:id:USAGI-WRP:20170921015149p:plain:w32

参考

  1. Is there Something like a Dark Background Excel Theme? - Super User

UE4: 4.16 から 4.17 へアップグレードした際に遭遇した諸問題と解決について

UE4 4.16 4.17 upgrade project plugin trouble-shoot CustomGravityPlugin IWYU Kismet module HMD Microsoft Visual Studio

4.16で開発していたプロジェクトを4.17へアップグレードした際に遭遇した問題と解決方法を整理します。

問題と解決方法

1. 4.15 向けのプラグインがビルド不能に陥った

レベル内の重力を器用に扱いたい場合に便利なプラグインとして CustomGravityPlugin （参考1）があります↓。更新が4ヶ月以上停止していて、4.15以降ではwarningが生じる状態（但しビルドはできた）でした。4.17ではビルドできなくなりました。

このプラグインを4.17で使う際の問題は、4.15で導入された ReadOnlyTargetRules に対応したコンストラクターを定義した <plugin>.Build.cs が定義されていない事でした。修正せずにビルドを試みると以下のような警告が表示されます。

C:\Users\usagi\tmp\\Plugins\CustomGravityPlugin\Source\CustomGravityPlugin\CustomGravityPlugin.Build.cs: warning: Module constructors should take a ReadOnlyTargetRules argument (rather than a TargetInfo argument) and pass it to the base class c onstructor from 4.15 onwards. Please update the method signature.

また、このプラグインはIWYU（参考2、参考3、参考4）に対応したコードになっていないため、ついでにIWYUにも対応しました。

<plugin>.Build.cs の ctor を ReadOnlyTargetRules をサポートするよう書き換え、IWYUの運用を設定します。

// original
public CustomGravityPlugin(TargetInfo Target)
{
// changed
public CustomGravityPlugin(ReadOnlyTargetRules Target) : base(Target)
{
  // IWYU 対応
  PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
  // memo: CustomGravityPlugin の場合は 4.16 時点でもこれがないとビルドできません。
  // 4.17でも同様なので、他の PublicIncludePaths.AddRange などと同様に ctor 内に書き加えます。
  PublicDependencyModuleNames.AddRange
  ( new string[]
    { "Core", "CoreUObject", "Engine", "InputCore"
    }
  );

その後、プラグインの全ての .h ファイルの冒頭へ #include "CoreMinimal.h" と必要に応じた UE4 のヘッダーファイルの #include を API リファレンスなど参考に書き加え、全ての .cpp ファイルの冒頭へ #include "<source>.h" を書き加えます。

2. ヘッドマウントディスプレイ関連のコードがリンクエラーやwarningを出すようになった

4.17からヘッドマウントディスプレイ関連のコードがモジュール化されました（参考5）。これに伴い、ヘッドマウントディスプレイを扱うUE4のプロジェクトを4.16から4.17へアップグレードする際には主に2つの修正作業が必要です。

  1. ヘッドマウントディスプレイ関連の #include "Kismet/<file>.h" を #include "<file>.h" へ変更します。（Kismet/が付かなくなります。）
  2. <project>.Build.cs の PublicDependencyModuleNames.AddRange へ HeadMountedDisply を追加しモジュールに必要なライブラリーのリンクを定義します。
// 4.16 以前
#include "Kismet/HeadMountedDisplayFunctionLibrary.h"
// 4.17 以降
#include "HeadMountedDisplayFunctionLibrary.h"

PublicDependencyModuleNames.AddRange
  ( new string[]
    { "Core", "CoreUObject", "Engine", "InputCore"
    // ↓ヘッドマウントディスプレイのモジュール
    , "HeadMountedDisplay"
    }
  );

3. operator[] の呼び出しコードを文法エラー扱いされるようになった

int operator[]( int ) が定義されたクラスの内部でこれを使いたい場合、auto result = operator[]( parameter ); のように記述できるが（参考6）、そのようなコードについて、

error C3861: ‘[]’: identifier not found

のようにエラーを出力されコンパイル不能扱いされてしまいました。

これは正確にはUE4、4.16から4.17へアップグレードとは直接の関係は無く、Windows 環境向けに Microsoft Visual Studio という（残念ながら）昔から間抜けな実装やバグでも有名な開発環境を使用している場合に起こる問題でした。

4.16のプロジェクトを4.17のエンジンでアップグレードして読み込もうとした際に作られるプロジェクトのコピーのプロジェクト設定のPlatform、Windows、Toolchain の設定が default にセットされた状態となり、 4.16 のプロジェクトの際には Visual Studio 2017 を指定していたプロジェクトのソースの一部がアップグレード直後に default ( = Visual Studio 2015 ) でのビルドとなりコンパイル不能となっていました。

少し困った事に、 Unreal Editor の GUI が起動しない事にはどこかにある設定ファイルの該当項目を探し出してテキストエディターで書き換える手間が必要です。あるいは、一時的に operator[]( parameter ) のようなコードを (*this)[ parameter ] のようにバギーな旧式の Visual Studio でも問題の無いコードに書き換えてあげて一端ビルドが通る状態で Unreal Editor を起動させ、プロジェクト設定を GUI から変更する必要があります。

所感

4.16 プロジェクトを 4.17 へアップグレードする手間はゼロではありませんでしたが、それほど大変な事はありませんでした😃

参考

  1. GitHub - mhousse1247/UE4-CustomGravityPlugin: Unreal Engine 4 : Custom Gravity Plugin
  2. IWYUでコーディングしよう - #memo
  3. Game Engine Technology by Unreal
  4. Unreal Engine | IWYU リファレンス ガイド
  5. Game Engine Technology by Unreal
  6. [Wandbox]三へ( へ՞ਊ ՞)へ ﾊｯﾊｯ